Merge pull request #4 from scalytics/novatechflow/refactor

refactor: move module to repo root and complete kafclaw rename

Author: novatechflow

gomikrobot/.env.example .env.examplegomikrobot/.env.example renamed to .env.example

@@ -35,29 +35,29 @@ jobs:
         uses: actions/setup-go@v5
         with:
           go-version: "1.24.13"
-          cache-dependency-path: gomikrobot/go.sum
+          cache-dependency-path: go.sum
 
       - name: Extract version from tag
         id: version
         run: echo "tag=${GITHUB_REF#refs/tags/}" >> "$GITHUB_OUTPUT"
 
       - name: Build
-        working-directory: gomikrobot
+        working-directory: .
         env:
           GOOS: ${{ matrix.goos }}
           GOARCH: ${{ matrix.goarch }}
           CGO_ENABLED: "0"
         run: |
-          BIN_NAME="gomikrobot-${{ matrix.goos }}-${{ matrix.goarch }}"
-          go build -ldflags "-X github.com/KafClaw/KafClaw/gomikrobot/cmd/gomikrobot/cmd.version=${{ steps.version.outputs.tag }}" \
-            -o "dist/${BIN_NAME}" ./cmd/gomikrobot
+          BIN_NAME="kafclaw-${{ matrix.goos }}-${{ matrix.goarch }}"
+          go build -ldflags "-X github.com/KafClaw/KafClaw/cmd/kafclaw/cmd.version=${{ steps.version.outputs.tag }}" \
+            -o "dist/${BIN_NAME}" ./cmd/kafclaw
           chmod +x "dist/${BIN_NAME}"
 
       - name: Upload artifact
         uses: actions/upload-artifact@v4
         with:
-          name: gomikrobot-${{ matrix.goos }}-${{ matrix.goarch }}
-          path: gomikrobot/dist/*
+          name: kafclaw-${{ matrix.goos }}-${{ matrix.goarch }}
+          path: dist/*
 
   # -------------------------------------------------------------------
   # Job 2: Package Electron desktop app (needs native runners)
@@ -84,42 +84,42 @@ jobs:
         uses: actions/setup-go@v5
         with:
           go-version: "1.24.13"
-          cache-dependency-path: gomikrobot/go.sum
+          cache-dependency-path: go.sum
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: "20"
 
       - name: Build Go binary for target platform
-        working-directory: gomikrobot
+        working-directory: .
         env:
           GOOS: ${{ matrix.go_goos }}
           GOARCH: ${{ matrix.go_goarch }}
           CGO_ENABLED: "0"
         run: |
-          go build -o gomikrobot ./cmd/gomikrobot
-          chmod +x gomikrobot
+          go build -o kafclaw ./cmd/kafclaw
+          chmod +x kafclaw
 
       - name: Install Electron dependencies
-        working-directory: gomikrobot/electron
+        working-directory: electron
         run: npm ci
 
       - name: Build Electron app
-        working-directory: gomikrobot/electron
+        working-directory: electron
         run: npm run build
 
       - name: Package Electron app
-        working-directory: gomikrobot/electron
+        working-directory: electron
         run: npx electron-builder --${{ matrix.platform }} --publish never
 
       - name: Upload Electron artifacts
         uses: actions/upload-artifact@v4
         with:
           name: electron-${{ matrix.platform }}
           path: |
-            gomikrobot/electron/release/*.dmg
-            gomikrobot/electron/release/*.AppImage
+            electron/release/*.dmg
+            electron/release/*.AppImage
 
   # -------------------------------------------------------------------
   # Job 3: Publish GitHub Release with all artifacts
@@ -138,7 +138,7 @@ jobs:
         run: |
           mkdir -p release_files
           # Flatten Go binaries
-          find artifacts -name "gomikrobot-*" -type f -exec cp {} release_files/ \;
+          find artifacts -name "kafclaw-*" -type f -exec cp {} release_files/ \;
           # Flatten Electron packages
           find artifacts -name "*.dmg" -type f -exec cp {} release_files/ \;
           find artifacts -name "*.AppImage" -type f -exec cp {} release_files/ \;

.github/workflows/release.yml

@@ -31,8 +31,8 @@ go.work.sum
 # .idea/
 # .vscode/
 private/
-gomikrobot/gomikrobot
-gomikrobot/dist/
-gomikrobot/electron/node_modules/
-gomikrobot/electron/dist/
+/kafclaw
+dist/
+electron/node_modules/
+electron/dist/
 .DS_Store

.gitignore

@@ -36,7 +36,7 @@ Scheduler ┘       │              │              └── Memory (remember
 - **Graceful degradation**: Memory, group, orchestrator, ER1 are all optional
 - **Behavior parity first**: Migration from Python preserves behavior before optimizing
 - **Secure defaults**: Binds 127.0.0.1, tier-restricted tool execution, deny-pattern filtering
-- **Single SQLite database**: All persistent state in `~/.gomikrobot/timeline.db`
+- **Single SQLite database**: All persistent state in `~/.kafclaw/timeline.db`
 
 ### Three Repositories Model
 
@@ -46,7 +46,7 @@ KafClaw organizes state across three logical repositories:
 |-----------|---------|-----------------|----------|
 | **Identity (Workspace)** | Soul files defining personality, behavior, tools, and user profile | `~/KafClaw-Workspace/` | Yes — user-customizable |
 | **Work Repo** | Agent sandbox for files, memory, tasks, docs | `~/KafClaw-Workspace/` (same as workspace by default) | Yes — agent writes here |
-| **System Repo** | Bot source code, skills, operational guidance | `gomikrobot/` (this repo) | Read-only at runtime |
+| **System Repo** | Bot source code, skills, operational guidance | `kafclaw/` (this repo) | Read-only at runtime |
 
 **Identity Repository** — Contains the soul files loaded at startup into the LLM system prompt:
 
@@ -58,7 +58,7 @@ KafClaw organizes state across three logical repositories:
 | `TOOLS.md` | Tool reference with signatures and safety notes |
 | `USER.md` | User profile (name, timezone, preferences, work context) |
 
-Soul files are scaffolded by `gomikrobot onboard` from embedded templates (`internal/identity/templates/`). Users can then customize them freely. The canonical file list is defined once in `identity.TemplateNames`.
+Soul files are scaffolded by `kafclaw onboard` from embedded templates (`internal/identity/templates/`). Users can then customize them freely. The canonical file list is defined once in `identity.TemplateNames`.
 
 **Work Repository** — Git-initialized sandbox with standard directories: `requirements/`, `tasks/`, `docs/`, `memory/`. The agent's `write_file` tool targets this repo by default.
 
@@ -69,8 +69,8 @@ Soul files are scaffolded by `gomikrobot onboard` from embedded templates (`inte
 ## 2. Directory Structure
 
 ```
-gomikrobot/
-├── cmd/gomikrobot/cmd/           # CLI commands (Cobra)
+kafclaw/
+├── cmd/kafclaw/cmd/           # CLI commands (Cobra)
 │   ├── root.go                   # Root command, version (v2.5.3)
 │   ├── gateway.go                # Main daemon (~2800 lines, all API endpoints)
 │   ├── agent.go                  # Single-message CLI mode
@@ -124,8 +124,8 @@ gomikrobot/
 The gateway command (`runGateway`) initializes all subsystems in a specific dependency order:
 
 ```
- 1. Load Config          (env > ~/.gomikrobot/config.json > defaults)
- 2. Open Timeline DB     (~/.gomikrobot/timeline.db, schema migration)
+ 1. Load Config          (env > ~/.kafclaw/config.json > defaults)
+ 2. Open Timeline DB     (~/.kafclaw/timeline.db, schema migration)
  3. Seed Settings        (bot_repo_path, work_repo_path, lfs_proxy_url)
  4. Create Message Bus   (100-msg inbound/outbound buffers)
  5. Initialize Provider  (OpenAI + optional LocalWhisper wrapper)
@@ -323,15 +323,15 @@ type Channel interface {
 ```
 
 **WhatsApp** (via whatsmeow — native protocol, no Node bridge):
-- Session stored in `~/.gomikrobot/whatsapp.db`
+- Session stored in `~/.kafclaw/whatsapp.db`
 - Config: enabled, allowFrom list, dropUnauthorized, ignoreReactions
 - JID normalization (phone numbers to WhatsApp format)
 - Audio transcription via provider (Whisper)
 - Image handling (receives, stores to temp, references in content)
 
 ### 5.4 internal/config — Configuration
 
-Loading precedence: Environment vars (`MIKROBOT_*`) > `~/.gomikrobot/config.json` > defaults.
+Loading precedence: Environment vars (`MIKROBOT_*`) > `~/.kafclaw/config.json` > defaults.
 
 ```
 Config
@@ -887,7 +887,7 @@ make docker-build && make docker-up
 
 | Target | Action |
 |--------|--------|
-| `make build` | `go build ./cmd/gomikrobot` |
+| `make build` | `go build ./cmd/kafclaw` |
 | `make test` | `go test ./...` |
 | `make install` | Copy binary to `/usr/local/bin` |
 | `make run` / `run-full` / `run-headless` | Build + run in specific mode |
@@ -1004,7 +1004,7 @@ ContextBuilder.BuildSystemPrompt()
 
 ### Adding a New CLI Command
 
-1. Create file in `cmd/gomikrobot/cmd/`
+1. Create file in `cmd/kafclaw/cmd/`
 2. Define cobra command
 3. Register in `root.go` `init()`
 

gomikrobot/ARCHITECTURE.md ARCHITECTURE.mdgomikrobot/ARCHITECTURE.md renamed to ARCHITECTURE.md

@@ -4,24 +4,24 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-KafClaw (formerly GoMikroBot) is a personal AI assistant written in Go. The Go source lives in `gomikrobot/`. Sensitive specs, tasks, research, and governance docs live in the `private/` directory (gitignored — tracked separately).
+KafClaw (formerly KafClaw) is a personal AI assistant written in Go. The Go source lives in `kafclaw/`. Sensitive specs, tasks, research, and governance docs live in the `private/` directory (gitignored — tracked separately).
 
 ## Build & Run
 
-All Go commands run from the `gomikrobot/` directory:
+All Go commands run from the `kafclaw/` directory:
 
 ```bash
-cd gomikrobot
+cd KafClaw
 
 # Build
-make build                    # or: go build ./cmd/gomikrobot
+make build                    # or: go build ./cmd/kafclaw
 
 # Run gateway (multi-channel daemon)
 make run                      # build + run
 make rerun                    # kill existing ports 18790/18791, rebuild, run
 
 # Run single message
-./gomikrobot agent -m "hello"
+./kafclaw agent -m "hello"
 
 # Run tests
 go test ./...                 # all tests
@@ -42,8 +42,8 @@ make release-patch            # or release-minor, release-major
 KafClaw/
 ├── CLAUDE.md               ← this file
 ├── .github/workflows/      ← CI/CD (release.yml)
-├── gomikrobot/             ← Go source code
-│   ├── cmd/gomikrobot/     ← CLI entry point (cobra commands)
+├── kafclaw/             ← Go source code
+│   ├── cmd/kafclaw/     ← CLI entry point (cobra commands)
 │   ├── internal/           ← Core packages
 │   │   ├── agent/          ← Agent loop + context/soul-file loader
 │   │   ├── bus/            ← Async message bus (pub-sub)
@@ -52,7 +52,7 @@ KafClaw/
 │   │   ├── identity/       ← Embedded soul-file templates + workspace scaffolding
 │   │   ├── provider/       ← LLM provider abstraction (OpenAI/OpenRouter)
 │   │   ├── session/        ← Per-session conversation history (JSONL)
-│   │   ├── timeline/       ← SQLite event log (~/.gomikrobot/timeline.db)
+│   │   ├── timeline/       ← SQLite event log (~/.kafclaw/timeline.db)
 │   │   └── tools/          ← Registry-based tool system
 │   ├── web/                ← Web UI (HTML dashboard)
 │   ├── electron/           ← Electron desktop app wrapper
@@ -75,15 +75,15 @@ KafClaw/
 
 KafClaw organizes state across three logical repositories:
 
-- **Identity (Workspace)** — Soul files (IDENTITY.md, SOUL.md, AGENTS.md, TOOLS.md, USER.md) loaded at startup into the LLM system prompt. Scaffolded by `gomikrobot onboard`, user-customizable.
+- **Identity (Workspace)** — Soul files (IDENTITY.md, SOUL.md, AGENTS.md, TOOLS.md, USER.md) loaded at startup into the LLM system prompt. Scaffolded by `kafclaw onboard`, user-customizable.
 - **Work Repo** — Agent sandbox for files, memory, tasks, docs. Git-initialized. Default: `~/KafClaw-Workspace/`.
 - **System Repo** — Bot source code (this repo). Read-only at runtime. Contains skills and operational guidance.
 
 The canonical soul file list is `identity.TemplateNames` in `internal/identity/embed.go` — single source of truth used by both `agent/context.go` and `memory/indexer.go`.
 
 ## Workspace Scaffolding
 
-Running `gomikrobot onboard` creates `~/.gomikrobot/config.json` **and** scaffolds soul files into the workspace:
+Running `kafclaw onboard` creates `~/.kafclaw/config.json` **and** scaffolds soul files into the workspace:
 
 ```
 ~/KafClaw-Workspace/
@@ -108,20 +108,20 @@ CLI/WhatsApp → Message Bus → Agent Loop → LLM Provider (OpenAI/OpenRouter)
                            Context Builder (loads soul files from workspace/)
 ```
 
-### Key packages (`gomikrobot/internal/`)
+### Key packages (`internal/`)
 
 - **agent/** — Core agent loop (`loop.go`) and context/soul-file loader (`context.go`).
 - **bus/** — Async message bus decoupling channels from the agent loop (pub-sub).
 - **channels/** — External integrations. WhatsApp uses `whatsmeow` (native, no Node bridge).
-- **config/** — Config struct with env/file/default loading. Config file: `~/.gomikrobot/config.json`. Env prefix: `MIKROBOT_`.
+- **config/** — Config struct with env/file/default loading. Config file: `~/.kafclaw/config.json`. Env prefix: `MIKROBOT_`.
 - **provider/** — LLM provider abstraction. OpenAI/OpenRouter implementations, Whisper transcription, TTS.
 - **session/** — Per-session conversation history, JSONL persistence, thread-safe.
-- **timeline/** — SQLite event log at `~/.gomikrobot/timeline.db`.
+- **timeline/** — SQLite event log at `~/.kafclaw/timeline.db`.
 - **tools/** — Registry-based tool system. Filesystem ops have path safety; shell exec has deny-pattern filtering and timeout (default 60s).
 
 ## Configuration
 
-Loaded in order: env vars > `~/.gomikrobot/config.json` > defaults.
+Loaded in order: env vars > `~/.kafclaw/config.json` > defaults.
 
 Default model: `anthropic/claude-sonnet-4-5`. Default workspace: `~/KafClaw-Workspace`. Gateway ports: 18790 (API), 18791 (dashboard).
 
@@ -135,7 +135,7 @@ Shell execution (`internal/tools/shell.go`) uses deny-pattern filtering (blocks
 
 **New channel:** Implement `Channel` interface in `internal/channels/`, subscribe to the message bus, add config fields to `internal/config/config.go`.
 
-**New CLI command:** Create file in `cmd/gomikrobot/cmd/`, define cobra command, register in `root.go` init().
+**New CLI command:** Create file in `cmd/kafclaw/cmd/`, define cobra command, register in `root.go` init().
 
 ## Task Workflow
 
@@ -160,4 +160,4 @@ Bug reports and task logs are **public** — they go in the code repo under `doc
 
 ## Go Module
 
-The Go module path is `github.com/KafClaw/KafClaw/gomikrobot`.
+The Go module path is `github.com/KafClaw/KafClaw`.

CLAUDE.md

@@ -10,14 +10,14 @@ WORKDIR /src
 COPY go.mod go.sum ./
 RUN go mod download
 COPY . .
-RUN CGO_ENABLED=1 go build -o /gomikrobot ./cmd/gomikrobot
+RUN CGO_ENABLED=1 go build -o /kafclaw ./cmd/kafclaw
 
 # ---- Runtime ----
 FROM alpine:3.20
 
 RUN apk add --no-cache ca-certificates git
 
-COPY --from=builder /gomikrobot /usr/local/bin/gomikrobot
+COPY --from=builder /kafclaw /usr/local/bin/kafclaw
 COPY web /app/web
 COPY scripts/docker-entrypoint.sh /app/docker-entrypoint.sh
 RUN chmod +x /app/docker-entrypoint.sh

gomikrobot/Dockerfile Dockerfilegomikrobot/Dockerfile renamed to Dockerfile

@@ -106,29 +106,29 @@ test-classification: ## Run internal/external message classification E2E test (v
 test-orchestrator: ## Run orchestrator tests (verbose)
 	go test -v ./internal/orchestrator/
 
-build: check ## Build the gomikrobot binary
-	go build ./cmd/gomikrobot
+build: check ## Build the kafclaw binary
+	go build ./cmd/kafclaw
 
-install: build ## Install gomikrobot to /usr/local/bin
-	cp gomikrobot /usr/local/bin/gomikrobot
-	@echo "Installed to /usr/local/bin/gomikrobot"
+install: build ## Install kafclaw to /usr/local/bin
+	cp kafclaw /usr/local/bin/kafclaw
+	@echo "Installed to /usr/local/bin/kafclaw"
 
 # ---------------------------------------------------------------------------
 # Three operation modes (Go gateway)
 # ---------------------------------------------------------------------------
 
 run: build ## Build and run gateway (default, standalone mode)
-	$(SOURCE_ENV) ./gomikrobot gateway
+	$(SOURCE_ENV) ./kafclaw gateway
 
 run-standalone: build ## Mode 2: Standalone desktop — no Kafka, no orchestrator
 	$(SOURCE_ENV) MIKROBOT_GROUP_ENABLED=false \
-	./gomikrobot gateway
+	./kafclaw gateway
 
 run-full: build ## Mode 1: Full desktop — group + orchestrator enabled
 	$(SOURCE_ENV) MIKROBOT_GROUP_ENABLED=true \
 	MIKROBOT_ORCHESTRATOR_ENABLED=true \
 	MIKROBOT_ORCHESTRATOR_ROLE=orchestrator \
-	./gomikrobot gateway
+	./kafclaw gateway
 
 run-headless: build ## Mode 3: Headless — binds 0.0.0.0, auth token required
 	@if [ -z "$$MIKROBOT_GATEWAY_AUTH_TOKEN" ]; then \
@@ -144,7 +144,7 @@ run-headless: build ## Mode 3: Headless — binds 0.0.0.0, auth token required
 	MIKROBOT_GROUP_ENABLED=true \
 	MIKROBOT_ORCHESTRATOR_ENABLED=true \
 	MIKROBOT_ORCHESTRATOR_ROLE=orchestrator \
-	./gomikrobot gateway
+	./kafclaw gateway
 
 kill-gateway: ## Kill any running gateway on ports 18790/18791
 	@set -euo pipefail; \
@@ -222,18 +222,18 @@ release-patch: ## Bump patch version, commit, tag, push → triggers CI release
 
 dist-go: ## Cross-compile Go binaries locally (all platforms)
 	@mkdir -p dist
-	GOOS=darwin  GOARCH=arm64 go build -o dist/gomikrobot-darwin-arm64  ./cmd/gomikrobot
-	GOOS=darwin  GOARCH=amd64 go build -o dist/gomikrobot-darwin-amd64  ./cmd/gomikrobot
-	GOOS=linux   GOARCH=amd64 go build -o dist/gomikrobot-linux-amd64   ./cmd/gomikrobot
-	GOOS=linux   GOARCH=arm64 go build -o dist/gomikrobot-linux-arm64   ./cmd/gomikrobot
+	GOOS=darwin  GOARCH=arm64 go build -o dist/kafclaw-darwin-arm64  ./cmd/kafclaw
+	GOOS=darwin  GOARCH=amd64 go build -o dist/kafclaw-darwin-amd64  ./cmd/kafclaw
+	GOOS=linux   GOARCH=amd64 go build -o dist/kafclaw-linux-amd64   ./cmd/kafclaw
+	GOOS=linux   GOARCH=arm64 go build -o dist/kafclaw-linux-arm64   ./cmd/kafclaw
 	@echo "Built 4 binaries in dist/"
-	@ls -lh dist/gomikrobot-*
+	@ls -lh dist/kafclaw-*
 
 # ---------------------------------------------------------------------------
 # Docker
 # ---------------------------------------------------------------------------
 
-docker-build: ## Build local Docker image (gomikrobot:local) — multi-stage, no host binary needed
+docker-build: ## Build local Docker image (kafclaw:local) — multi-stage, no host binary needed
 	docker build -t kafclaw:local -f Dockerfile .
 
 docker-up: docker-build ## Start docker-compose using local image only

gomikrobot/MEMORY.md MEMORY.mdgomikrobot/MEMORY.md renamed to MEMORY.md

@@ -1,4 +1,4 @@
-KafClaw (GoMikroBot)
+KafClaw (KafClaw)
 Copyright 2025-2026 KafClaw contributors
 
 This product includes software developed at