Rename loom → heddle, framework → baseline

Update all references for the repo reorganization:
- Package dep: loom-ai → heddle-ai
- All imports: from loom.* → from heddle.*
- CLI commands: loom worker/mcp/pipeline → heddle worker/mcp/pipeline
- framework/ directory refs → baseline/
- GitHub URLs: IranTransitionProject/loom → getheddle/heddle
- GitHub URLs: IranTransitionProject/framework → IranTransitionProject/baseline
- Helm charts, Dockerfiles, CI, configs, docs all updated
- All 381 tests passing

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Hooman Mehr

.github/workflows/ci.yml

@@ -24,10 +24,10 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/checkout@v4
         with:
-          repository: IranTransitionProject/loom
-          path: loom
+          repository: getheddle/heddle
+          path: heddle
       - uses: astral-sh/setup-uv@v5
-      - run: ln -s $GITHUB_WORKSPACE/loom $GITHUB_WORKSPACE/../loom
+      - run: ln -s $GITHUB_WORKSPACE/heddle $GITHUB_WORKSPACE/../heddle
       - run: uv sync --extra dev
       - name: Ruff lint
         run: uv run ruff check scripts/ pipeline/scripts/ tests/
@@ -43,12 +43,12 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/checkout@v4
         with:
-          repository: IranTransitionProject/loom
-          path: loom
+          repository: getheddle/heddle
+          path: heddle
       - uses: astral-sh/setup-uv@v5
         with:
           python-version: ${{ matrix.python-version }}
-      - run: ln -s $GITHUB_WORKSPACE/loom $GITHUB_WORKSPACE/../loom
+      - run: ln -s $GITHUB_WORKSPACE/heddle $GITHUB_WORKSPACE/../heddle
       - name: Install dependencies
         run: uv sync --extra dev
       - name: Run tests with coverage

.github/workflows/docker.yml

@@ -40,11 +40,11 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Checkout loom
+      - name: Checkout heddle
         uses: actions/checkout@v4
         with:
-          repository: IranTransitionProject/loom
-          path: loom
+          repository: getheddle/heddle
+          path: heddle
 
       - name: Log in to GHCR
         uses: docker/login-action@v3

.github/workflows/docs.yml

@@ -37,7 +37,7 @@ jobs:
         run: .docs-venv/bin/mkdocs build
         env:
           MKDOCSTRINGS_ENABLED: "false"
-          # API reference pages require baft importable (needs ../loom).
+          # API reference pages require baft importable (needs ../heddle).
           # Disable mkdocstrings in CI; API docs render locally.
 
       - name: Upload artifact

CLAUDE.md

@@ -6,13 +6,13 @@
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 [![License: MPL 2.0](https://img.shields.io/badge/License-MPL_2.0-brightgreen.svg)](LICENSE)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
-<!-- Keep in sync with loom pyproject.toml version -->
-[![Built on Loom](https://img.shields.io/badge/built_on-Loom_v0.9.0-blueviolet.svg)](https://github.com/IranTransitionProject/loom)
+<!-- Keep in sync with heddle pyproject.toml version -->
+[![Built on Heddle](https://img.shields.io/badge/built_on-Loom_v0.9.0-blueviolet.svg)](https://github.com/getheddle/heddle)
 [![Status: Active Development](https://img.shields.io/badge/status-active_development-brightgreen.svg)]()
 
 **Persian:** بافت — *woven fabric, texture, tissue*
 
-Baft is the Iran Transition Project's analytical engine. It is an application built on the [Loom](https://github.com/IranTransitionProject/loom) actor mesh framework and the [framework](https://github.com/IranTransitionProject/framework) YAML database.
+Baft is the Iran Transition Project's analytical engine. It is an application built on the [Loom](https://github.com/getheddle/heddle) actor mesh framework and the [framework](https://github.com/IranTransitionProject/baseline) YAML database.
 
 ![Three-Repo Architecture](docs/images/three-repo-architecture.svg)
 
@@ -109,17 +109,17 @@ See [Helm Deployment Guide](docs/HELM_DEPLOYMENT.md) for full Kubernetes setup.
 
 - Python 3.11+
 - [uv](https://docs.astral.sh/uv/) package manager
-- [Loom](https://github.com/IranTransitionProject/loom) cloned as sibling directory (`../loom`)
+- [Loom](https://github.com/getheddle/heddle) cloned as sibling directory (`../heddle`)
 - [Ollama](https://ollama.com/) for local-tier workers
 - NATS server (`brew install nats-server` or Docker)
 - Valkey (`brew install valkey` or Docker) — optional, for checkpoints
 - Anthropic API key (`export ANTHROPIC_API_KEY=sk-ant-...`) — for standard/frontier tier
-- `ITP_ROOT` env var set to the project root (parent of `framework/`, `loom/`, `baft/`)
+- `ITP_ROOT` env var set to the project root (parent of `baseline/`, `heddle/`, `baft/`)
 
 ## Quick start
 
 ```bash
-# 1. Install (resolves loom from ../loom automatically)
+# 1. Install (resolves heddle from ../heddle automatically)
 uv sync --extra dev
 
 # 2. Infrastructure
@@ -133,18 +133,18 @@ uv run python pipeline/scripts/itp_import_to_duckdb.py
 bash scripts/run_workers.sh
 
 # 5. Start MCP gateway (stdio for Claude Code)
-uv run loom mcp --config configs/mcp/itp.yaml
+uv run heddle mcp --config configs/mcp/itp.yaml
 
 # 6. Start MCP gateway (HTTP for claude.ai)
-uv run loom mcp --config configs/mcp/itp.yaml --transport streamable-http --port 8765
+uv run heddle mcp --config configs/mcp/itp.yaml --transport streamable-http --port 8765
 ```
 
 ## Relationship to other ITP repos
 
 | Repo | Role |
 |------|------|
-| [framework](https://github.com/IranTransitionProject/framework) | Analytical database (YAML source of truth) |
-| [loom](https://github.com/IranTransitionProject/loom) | Actor mesh framework (infrastructure) |
+| [framework](https://github.com/IranTransitionProject/baseline) | Analytical database (YAML source of truth) |
+| [heddle](https://github.com/getheddle/heddle) | Actor mesh framework (infrastructure) |
 | **baft** (this repo) | ITP application layer (config + scripts) |
 
 ## Documentation

README.md

@@ -1,6 +1,6 @@
 apiVersion: v2
 name: baft
-description: ITP analytical engine — multi-agent intelligence analysis system on Loom
+description: ITP analytical engine — multi-agent intelligence analysis system on Heddle
 type: application
 version: 0.1.0
 appVersion: "0.3.0"
@@ -13,6 +13,6 @@ keywords:
 home: https://github.com/IranTransitionProject/baft
 sources:
   - https://github.com/IranTransitionProject/baft
-  - https://github.com/IranTransitionProject/loom
+  - https://github.com/getheddle/heddle
 maintainers:
   - name: ITP Team

charts/baft/Chart.yaml

@@ -1,6 +1,6 @@
 # Baft Helm Chart
 
-Deploy the ITP analytical engine (baft + loom) on Kubernetes.
+Deploy the ITP analytical engine (baft + heddle) on Kubernetes.
 
 ## Quick start
 
@@ -58,6 +58,6 @@ mcp:
 ## Constraints
 
 - **DE worker must be replicas: 1** — serialized writes invariant
-- **Framework PVC is ReadWriteOnce** — only framework-sync writes
-- **Workers mount framework read-only**
+- **Baseline PVC is ReadWriteOnce** — only baseline-sync writes
+- **Workers mount baseline read-only**
 - **Secrets must never go in values.yaml**

charts/baft/README.md

@@ -65,9 +65,9 @@ Common environment variables injected into all pods
 {{/*
 Framework volume mounts (read-only for workers)
 */}}
-{{- define "baft.frameworkVolumeMount" -}}
-- name: framework-data
-  mountPath: /data/framework
+{{- define "baft.baselineVolumeMount" -}}
+- name: baseline-data
+  mountPath: /data/baseline
   readOnly: true
 {{- end }}
 

charts/baft/templates/_helpers.tpl

@@ -1,48 +1,48 @@
 apiVersion: v1
 kind: PersistentVolumeClaim
 metadata:
-  name: framework-data
+  name: baseline-data
   namespace: {{ .Values.namespace }}
   labels:
     {{- include "baft.labels" . | nindent 4 }}
 spec:
   accessModes: [ReadWriteOnce]
   resources:
     requests:
-      storage: {{ .Values.framework.storage }}
+      storage: {{ .Values.baseline.storage }}
 ---
 apiVersion: apps/v1
 kind: Deployment
 metadata:
-  name: framework-sync
+  name: baseline-sync
   namespace: {{ .Values.namespace }}
   labels:
     {{- include "baft.labels" . | nindent 4 }}
-    app.kubernetes.io/name: framework-sync
+    app.kubernetes.io/name: baseline-sync
 spec:
   replicas: 1
   strategy:
     type: Recreate
   selector:
     matchLabels:
-      app.kubernetes.io/name: framework-sync
+      app.kubernetes.io/name: baseline-sync
   template:
     metadata:
       labels:
-        app.kubernetes.io/name: framework-sync
+        app.kubernetes.io/name: baseline-sync
     spec:
       initContainers:
         - name: git-clone
           image: registry.k8s.io/git-sync/git-sync:v4
           args:
-            - "--repo={{ .Values.framework.repo }}"
-            - "--ref={{ .Values.framework.branch }}"
-            - "--root=/data/framework"
+            - "--repo={{ .Values.baseline.repo }}"
+            - "--ref={{ .Values.baseline.branch }}"
+            - "--root=/data/baseline"
             - "--one-time"
           volumeMounts:
-            - name: framework-data
-              mountPath: /data/framework
-          {{- if .Values.framework.sshKeySecret }}
+            - name: baseline-data
+              mountPath: /data/baseline
+          {{- if .Values.baseline.sshKeySecret }}
           env:
             - name: GIT_SYNC_SSH_KEY_FILE
               value: /etc/git-secret/id_rsa
@@ -55,44 +55,44 @@ spec:
         - name: git-sync
           image: registry.k8s.io/git-sync/git-sync:v4
           args:
-            - "--repo={{ .Values.framework.repo }}"
-            - "--ref={{ .Values.framework.branch }}"
-            - "--root=/data/framework"
-            - "--period={{ .Values.framework.syncInterval }}s"
+            - "--repo={{ .Values.baseline.repo }}"
+            - "--ref={{ .Values.baseline.branch }}"
+            - "--root=/data/baseline"
+            - "--period={{ .Values.baseline.syncInterval }}s"
           volumeMounts:
-            - name: framework-data
-              mountPath: /data/framework
-          {{- if .Values.framework.sshKeySecret }}
+            - name: baseline-data
+              mountPath: /data/baseline
+          {{- if .Values.baseline.sshKeySecret }}
           env:
             - name: GIT_SYNC_SSH_KEY_FILE
               value: /etc/git-secret/id_rsa
           {{- end }}
-        {{- if .Values.framework.commitAgent.enabled }}
+        {{- if .Values.baseline.commitAgent.enabled }}
         - name: commit-agent
           image: alpine/git:latest
           command: ["/bin/sh", "-c"]
           args:
             - |
               while true; do
-                sleep {{ .Values.framework.commitAgent.interval }}
-                cd /data/framework
+                sleep {{ .Values.baseline.commitAgent.interval }}
+                cd /data/baseline
                 git add -A
                 if ! git diff --cached --quiet; then
-                  git commit -m "{{ .Values.framework.commitAgent.message }} — $(date -u +%Y-%m-%dT%H:%M:%SZ)"
+                  git commit -m "{{ .Values.baseline.commitAgent.message }} — $(date -u +%Y-%m-%dT%H:%M:%SZ)"
                   git push || echo "Push failed — will retry next cycle"
                 fi
               done
           volumeMounts:
-            - name: framework-data
-              mountPath: /data/framework
+            - name: baseline-data
+              mountPath: /data/baseline
         {{- end }}
       volumes:
-        - name: framework-data
+        - name: baseline-data
           persistentVolumeClaim:
-            claimName: framework-data
-        {{- if .Values.framework.sshKeySecret }}
+            claimName: baseline-data
+        {{- if .Values.baseline.sshKeySecret }}
         - name: git-secret
           secret:
-            secretName: {{ .Values.framework.sshKeySecret }}
+            secretName: {{ .Values.baseline.sshKeySecret }}
             defaultMode: 0400
         {{- end }}

charts/baft/templates/framework-sync.yaml charts/baft/templates/baseline-sync.yamlcharts/baft/templates/framework-sync.yaml renamed to charts/baft/templates/baseline-sync.yaml

@@ -34,12 +34,12 @@ spec:
           env:
             {{- include "baft.envVars" . | nindent 12 }}
           volumeMounts:
-            {{- include "baft.frameworkVolumeMount" . | nindent 12 }}
+            {{- include "baft.baselineVolumeMount" . | nindent 12 }}
             {{- include "baft.duckdbVolumeMount" . | nindent 12 }}
       volumes:
-        - name: framework-data
+        - name: baseline-data
           persistentVolumeClaim:
-            claimName: framework-data
+            claimName: baseline-data
         - name: duckdb-data
           persistentVolumeClaim:
             claimName: duckdb-data
@@ -68,12 +68,12 @@ spec:
               env:
                 {{- include "baft.envVars" . | nindent 16 }}
               volumeMounts:
-                {{- include "baft.frameworkVolumeMount" . | nindent 16 }}
+                {{- include "baft.baselineVolumeMount" . | nindent 16 }}
                 {{- include "baft.duckdbVolumeMount" . | nindent 16 }}
           volumes:
-            - name: framework-data
+            - name: baseline-data
               persistentVolumeClaim:
-                claimName: framework-data
+                claimName: baseline-data
             - name: duckdb-data
               persistentVolumeClaim:
                 claimName: duckdb-data