cymatix-context 0.8.0__tar.gz

cymatix_context-0.8.0/.env.example

@@ -0,0 +1,308 @@
+# helix-context — environment variable reference
+#
+# Copy to `.env` and source before running helix:
+#   set -a; source .env; set +a                # bash / WSL
+#   for /F "tokens=*" %i in (.env) do set %i   # cmd
+#
+# Vars marked [REQUIRED] must be set; others are optional with sensible
+# defaults. [DARK-SHIP] = wired but off-by-default (Phase 2 / experimental).
+# [TEST-ONLY] = used by benchmarks/tests only, not server runtime.
+# [LEGACY] = back-compat alias kept for older clients; prefer the modern name.
+#
+# Verified by grep against helix_context/, scripts/, benchmarks/, and the
+# launcher .bat files on 2026-05-10. File:line citations on each var.
+
+
+# ─── Attribution (4-layer identity contract) ─────────────────────────────────
+# These tag every gene the server writes for cross-machine federation.
+# See FEDERATION_LOCAL.md and helix_context/server.py:_resolve_default_attribution.
+
+# HELIX_ORG: organization slug — top of the 4-layer attribution stack.
+# Falls back to "local" when unset. Set per shell to group machines under
+# a common operator (e.g. "swiftwing", "acme").                  [OPTIONAL]
+HELIX_ORG=local
+# src: helix_context/server.py:139, helix_context/mcp_server.py:277
+
+# HELIX_DEVICE: device/PC label in the federation stack. Doubles as the
+# hardware picker for ribosome inference: auto | cuda | rocm | mps | cpu.
+# When unset, server falls back to HELIX_PARTY then socket.gethostname().
+# Override one-shot via HELIX_DEVICE=cpu to force CPU on a GPU box.   [OPTIONAL]
+HELIX_DEVICE=auto
+# src: helix_context/hardware.py:40, helix_context/server.py:145, helix_context/mcp_server.py:279
+
+# HELIX_USER: human operator handle (the "who is at the keyboard" layer).
+# Falls back to getpass.getuser() when unset. Distinct from HELIX_AGENT — a
+# user can run multiple agents (laude/raude/taude) from one login.   [OPTIONAL]
+HELIX_USER=
+# src: helix_context/server.py:161, helix_context/mcp_server.py:283
+
+# HELIX_AGENT: AI persona writing genes (laude / raude / taude / gemini /
+# openwebui / etc). When unset, ingests are tagged "manual / no AI persona."
+# Pre-4-layer code overloaded this as the user handle; the server still
+# honors that legacy fallback when only HELIX_AGENT is set.          [OPTIONAL]
+HELIX_AGENT=
+# src: helix_context/server.py:153, helix_context/mcp_server.py:285
+
+# HELIX_AGENT_KIND: agent vendor/family axis — e.g. "claude-code", "gemini",
+# "ollama-chat", "vscode". Falls back to HELIX_MCP_HOST when omitted.
+# Drives dashboard chip rendering and capability tags.               [OPTIONAL]
+HELIX_AGENT_KIND=
+# src: helix_context/mcp_server.py:288, helix_context/mcp_server.py:969
+
+# HELIX_PARTY_ID: party/device identifier for CWoLa session attribution and
+# session-registry presence. Resolution order: HELIX_PARTY_ID > HELIX_DEVICE
+# > HELIX_PARTY > socket.gethostname(). Set in helix.toml [server] also.   [OPTIONAL]
+HELIX_PARTY_ID=
+# src: helix_context/mcp_server.py:135, helix_context/mcp_server.py:280
+
+# HELIX_MCP_HANDLE: stable handle for one MCP session in the live registry.
+# Convention: laude (Claude Code), raude (claude.ai), taude (Cursor),
+# gemini (Gemini CLI), openwebui (Open WebUI). Defaults to "mcp-<pid>"
+# when unset — unique per process but anonymous.                     [OPTIONAL]
+HELIX_MCP_HANDLE=
+# src: helix_context/mcp_server.py:119, helix_context/mcp_server.py:966
+
+# HELIX_MCP_HOST: MCP host/tool family — used as a capability tag
+# ("host:claude-code") on the live registry chip. Defaults to "unknown"
+# when unset, which the launcher heuristically remaps via VSCODE_PID
+# / CURSOR_TRACE_ID detection.                                       [OPTIONAL]
+HELIX_MCP_HOST=
+# src: helix_context/mcp_server.py:968, helix_context/launcher/ide_fingerprint.py:37
+
+# HELIX_PARTY: legacy alias for HELIX_DEVICE / HELIX_PARTY_ID. Still read
+# for back-compat with pre-4-layer clients. Prefer HELIX_PARTY_ID.   [LEGACY]
+HELIX_PARTY=
+# src: helix_context/server.py:146, helix_context/mcp_server.py:281
+
+
+# ─── Server / config ─────────────────────────────────────────────────────────
+
+# HELIX_CONFIG: path to helix.toml. Default is "helix.toml" in cwd.   [OPTIONAL]
+HELIX_CONFIG=helix.toml
+# src: helix_context/config.py:521
+
+# HELIX_GENOME_PATH: SQLite genome path — overrides [genome].path in
+# helix.toml. Use with HELIX_USE_SHARDS=1 for a routing DB.           [OPTIONAL]
+HELIX_GENOME_PATH=
+# src: helix_context/config.py:611
+
+# HELIX_SERVER_UPSTREAM: OpenAI-compatible upstream URL (Ollama / OpenAI /
+# headroom). Overrides [server].upstream. Set automatically when the
+# launcher routes through headroom.                                   [OPTIONAL]
+HELIX_SERVER_UPSTREAM=
+# src: helix_context/config.py:616, helix_context/launcher/app.py:328
+
+# HELIX_SERVER_UPSTREAM_TIMEOUT: seconds for upstream chat completions.
+# Overrides [server].upstream_timeout. Float.                         [OPTIONAL]
+HELIX_SERVER_UPSTREAM_TIMEOUT=
+# src: helix_context/config.py:618
+
+# HELIX_TZ: IANA timezone for the /context timestamp_local field
+# (e.g. 'America/Los_Angeles', 'Europe/Berlin'). Falls back to system tz.  [OPTIONAL]
+HELIX_TZ=
+# src: helix_context/server.py:85
+
+# HELIX_MCP_URL: helix HTTP base URL the MCP shim talks to.           [OPTIONAL]
+HELIX_MCP_URL=http://127.0.0.1:11437
+# src: helix_context/mcp_server.py:108
+
+# HELIX_MCP_TIMEOUT: per-request timeout (seconds) for the MCP shim.  [OPTIONAL]
+HELIX_MCP_TIMEOUT=30
+# src: helix_context/mcp_server.py:109
+
+# HELIX_MCP_LOG_LEVEL: logging level for the MCP shim process.        [OPTIONAL]
+HELIX_MCP_LOG_LEVEL=INFO
+# src: helix_context/mcp_server.py:1020
+
+# HELIX_URL: legacy MCP base URL. Read by helix_context/mcp/server.py
+# (the deprecated stdio shim) and benchmark scripts. Prefer HELIX_MCP_URL. [LEGACY]
+HELIX_URL=http://127.0.0.1:11437
+# src: helix_context/mcp/server.py:45, helix_context/vault/cli.py:18
+
+# HELIX_TIMEOUT: legacy MCP timeout. Prefer HELIX_MCP_TIMEOUT.        [LEGACY]
+HELIX_TIMEOUT=30
+# src: helix_context/mcp/server.py:46
+
+
+# ─── Observability ───────────────────────────────────────────────────────────
+
+# HELIX_OBSERVABILITY: master switch for the native observability sidecar
+# (Prometheus, Tempo, Loki, Grafana, OTel Collector). Set to 0 / false / no
+# / off to skip. Default ON when unset.                               [OPTIONAL]
+HELIX_OBSERVABILITY=1
+# src: helix_context/launcher/app.py:432
+
+# HELIX_OTEL_ENABLED: turn on OTel SDK init in the FastAPI server.
+# Default "0" (off). Set "1" to emit traces/metrics to the collector. [OPTIONAL]
+HELIX_OTEL_ENABLED=1
+# src: helix_context/telemetry.py:117
+
+# HELIX_OTEL_ENDPOINT: OTLP gRPC endpoint for the collector.          [OPTIONAL]
+HELIX_OTEL_ENDPOINT=localhost:4317
+# src: helix_context/telemetry.py:149
+
+# HELIX_OTEL_INSECURE: "1" for plain gRPC (dev-local), "0" for TLS.   [OPTIONAL]
+HELIX_OTEL_INSECURE=1
+# src: helix_context/telemetry.py:150
+
+# HELIX_OTEL_SAMPLER_RATIO: trace sampler 0.0-1.0. 1.0 = sample every span. [OPTIONAL]
+HELIX_OTEL_SAMPLER_RATIO=1.0
+# src: helix_context/telemetry.py:152
+
+# HELIX_OTEL_REDACT_QUERY: "1" hashes raw query strings in spans
+# (privacy default). Set "0" to ship raw queries — local dev only.    [OPTIONAL]
+HELIX_OTEL_REDACT_QUERY=1
+# src: helix_context/telemetry.py:77
+
+
+# ─── Headroom integration (proxy + dashboard) ────────────────────────────────
+
+# HELIX_HEADROOM_ENABLED: master switch — overrides [headroom].enabled
+# in helix.toml. Truthy ⇒ launcher adopts/spawns headroom on start.   [OPTIONAL]
+HELIX_HEADROOM_ENABLED=
+# src: helix_context/launcher/app.py:567
+
+# HELIX_HEADROOM_AUTOSTART: spawn headroom proxy if nothing is already
+# running on the configured port. Truthy ⇒ autostart.                 [OPTIONAL]
+HELIX_HEADROOM_AUTOSTART=
+# src: helix_context/launcher/app.py:566
+
+# HELIX_HEADROOM_ROUTE_UPSTREAM_AUTO: auto-route helix's OpenAI-compatible
+# chat upstream through headroom only when the upstream is non-local.
+# Local Ollama stays direct; remote providers gain headroom's proxy layer. [OPTIONAL]
+HELIX_HEADROOM_ROUTE_UPSTREAM_AUTO=
+# src: helix_context/launcher/app.py:544
+
+# HELIX_DISABLE_HEADROOM: kill-switch for A/B benchmarking — bypass the
+# headroom bridge entirely. Truthy ⇒ headroom hooks return None.      [OPTIONAL]
+HELIX_DISABLE_HEADROOM=
+# src: helix_context/headroom_bridge.py:52
+
+
+# ─── Feature toggles ─────────────────────────────────────────────────────────
+
+# HELIX_BUDGET_ZONE: enable the 2026-04-14 budget-zone gene-cap spike.
+# Clamps max_genes based on caller's incoming prompt token count.
+# Zones (128k window): <25% none, 25-40% cap 12, 40-60% cap 6,
+# 60-80% cap 3, 80%+ cap 1. Truthy ⇒ on.                              [OPTIONAL]
+HELIX_BUDGET_ZONE=1
+# src: helix_context/budget_zone.py:48
+
+# HELIX_FILENAME_ANCHOR_ENABLED: Tier 0.5 filename-anchor scoring —
+# boost candidates whose filename stem matches a query term. Off by
+# default to preserve existing tier behaviour.                        [OPTIONAL]
+HELIX_FILENAME_ANCHOR_ENABLED=
+# src: helix_context/filename_anchor.py:134, helix_context/context_manager.py:460
+
+# HELIX_LAYERED_FINGERPRINTS: Phase 2 claims-layer fingerprints (issue #8).
+# Off by default. Set "1" to write the layered fingerprint table.     [DARK-SHIP]
+HELIX_LAYERED_FINGERPRINTS=0
+# src: helix_context/genome.py:2848
+
+# HELIX_USE_SHARDS: open the genome via the sharded routing adapter
+# instead of the single-file SQLite path. Off by default until cutover. [DARK-SHIP]
+HELIX_USE_SHARDS=
+# src: helix_context/shard_router.py:243, helix_context/sharding.py:299
+
+# HELIX_WALKING_TIEBREAK: opt-in associative-graph ordering for
+# tied-score retrieval. A/B benchmarking flag.                        [DARK-SHIP]
+HELIX_WALKING_TIEBREAK=
+# src: helix_context/tie_break.py:42
+
+# HELIX_ABSTAIN_DISABLE: kill-switch for the abstain-tier (BROAD takes
+# negative space). Set "1" to force off even when helix.toml enables it.   [OPTIONAL]
+HELIX_ABSTAIN_DISABLE=
+# src: helix_context/context_manager.py:1036
+
+# HELIX_LAUNCHER_UPDATE_CHECK: 0 / false / no / off disables the
+# launcher's periodic pip-update check. Default ON.                   [OPTIONAL]
+HELIX_LAUNCHER_UPDATE_CHECK=1
+# src: helix_context/launcher/update_check.py:85
+
+
+# ─── mem_sync (background ingest daemon) ─────────────────────────────────────
+
+# HELIX_MEM_SYNC_URL: helix base URL for the mem_sync daemon's HTTP client.
+# Falls back to [mem_sync].helix_url in helix.toml.                   [OPTIONAL]
+HELIX_MEM_SYNC_URL=
+# src: scripts/run_mem_sync.py:73
+
+# HELIX_MEM_SYNC_INTERVAL: poll interval (seconds) between ingests.   [OPTIONAL]
+HELIX_MEM_SYNC_INTERVAL=
+# src: scripts/run_mem_sync.py:77
+
+# HELIX_MEM_SYNC_DIRS: pathsep-separated list of dirs to watch.       [OPTIONAL]
+HELIX_MEM_SYNC_DIRS=
+# src: scripts/run_mem_sync.py:80
+
+
+# ─── Bench / test-only ───────────────────────────────────────────────────────
+
+# HELIX_MODEL: downstream model id for benchmark scripts (qwen3:4b /
+# qwen3:8b / gemma4:e4b / etc). Not read by the server runtime.       [TEST-ONLY]
+HELIX_MODEL=
+# src: benchmarks/bench_needle.py:268, benchmarks/bench_needle_1000.py:61
+
+# HELIX_BENCH_REQUIRE_BM25_PARITY: gate the rag-vs-helix composition
+# bench on BM25 parity with the reference set.                        [TEST-ONLY]
+HELIX_BENCH_REQUIRE_BM25_PARITY=0
+# src: benchmarks/bench_helix_rag_composition.py:768
+
+# HELIX_SKIP_MONITOR: opt out of bench_needle_1000's monitor sidecar. [TEST-ONLY]
+HELIX_SKIP_MONITOR=
+# src: benchmarks/bench_needle_1000.py:867
+
+# HELIX_FUSION_MODE_LABEL: label tag for skill-activation bench rows. [TEST-ONLY]
+HELIX_FUSION_MODE_LABEL=additive
+# src: benchmarks/bench_skill_activation.py:287
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Consumed-by index (one-line summary per var)
+#
+#   HELIX_ABSTAIN_DISABLE              context_manager._build_abstain_signal kill-switch
+#   HELIX_AGENT                        ingest attribution AI agent handle
+#   HELIX_AGENT_KIND                   agent family axis (claude-code / gemini / ...)
+#   HELIX_BENCH_REQUIRE_BM25_PARITY    bench_helix_rag_composition.py gate
+#   HELIX_BUDGET_ZONE                  budget_zone.is_enabled — gene-cap spike
+#   HELIX_CONFIG                       helix.toml path
+#   HELIX_DEVICE                       hardware picker + device attribution
+#   HELIX_DISABLE_HEADROOM             headroom_bridge kill-switch (A/B)
+#   HELIX_FILENAME_ANCHOR_ENABLED      filename_anchor.is_enabled — Tier 0.5 toggle
+#   HELIX_FUSION_MODE_LABEL            bench_skill_activation row label
+#   HELIX_GENOME_PATH                  genome.path override
+#   HELIX_HEADROOM_AUTOSTART           launcher autostart override
+#   HELIX_HEADROOM_ENABLED             launcher headroom master switch
+#   HELIX_HEADROOM_ROUTE_UPSTREAM_AUTO conditional upstream route through headroom
+#   HELIX_LAUNCHER_UPDATE_CHECK        launcher self-update check toggle
+#   HELIX_LAYERED_FINGERPRINTS         genome.py Phase 2 claims layer toggle
+#   HELIX_MCP_HANDLE                   live MCP session handle for registry presence
+#   HELIX_MCP_HOST                     MCP host/tool-family capability tag
+#   HELIX_MCP_LOG_LEVEL                MCP shim logging level
+#   HELIX_MCP_TIMEOUT                  MCP shim per-request timeout
+#   HELIX_MCP_URL                      MCP shim → helix HTTP base URL
+#   HELIX_MEM_SYNC_DIRS                mem_sync watch_dirs override
+#   HELIX_MEM_SYNC_INTERVAL            mem_sync poll interval
+#   HELIX_MEM_SYNC_URL                 mem_sync helix base URL
+#   HELIX_MODEL                        bench downstream model id
+#   HELIX_OBSERVABILITY                native observability sidecar opt-out
+#   HELIX_ORG                          attribution org id
+#   HELIX_OTEL_ENABLED                 OTel SDK init switch
+#   HELIX_OTEL_ENDPOINT                OTLP gRPC endpoint
+#   HELIX_OTEL_INSECURE                OTLP plain-gRPC switch
+#   HELIX_OTEL_REDACT_QUERY            hash query strings in spans
+#   HELIX_OTEL_SAMPLER_RATIO           trace sampler ratio
+#   HELIX_PARTY                        legacy alias for HELIX_DEVICE / HELIX_PARTY_ID
+#   HELIX_PARTY_ID                     CWoLa party id + session attribution
+#   HELIX_SERVER_UPSTREAM              OpenAI-compatible upstream URL override
+#   HELIX_SERVER_UPSTREAM_TIMEOUT      upstream chat-completions timeout
+#   HELIX_SKIP_MONITOR                 bench_needle_1000 monitor opt-out
+#   HELIX_TIMEOUT                      legacy MCP timeout
+#   HELIX_TZ                           /context timestamp_local timezone
+#   HELIX_URL                          legacy MCP base URL
+#   HELIX_USE_SHARDS                   sharded genome adapter switch
+#   HELIX_USER                         human participant handle
+#   HELIX_WALKING_TIEBREAK             walking-tiebreak A/B flag
+#
+# (no HELIX_*_TOKEN / *_SECRET / *_KEY / *_API_KEY are read by the codebase
+#  — admin-endpoint auth is not implemented as of 2026-05-10).

cymatix_context-0.8.0/.github/ISSUE_TEMPLATE/enhancement.md

@@ -0,0 +1,34 @@
+---
+name: Enhancement request
+about: Suggest a new capability or extension to helix-context
+title: "[Enhancement] "
+labels: enhancement
+assignees: ''
+---
+
+## What you'd like to see
+
+A clear, concise description of the enhancement.
+
+## Why it matters
+
+- Use case
+- Who benefits
+- What's currently blocked or awkward without it
+
+## Implementation sketch (optional)
+
+If you have a sense of how this could land, share. Otherwise, no obligation — the value of this template is capturing the *need*, not the implementation.
+
+## Hardware / environment specifics (if relevant)
+
+If the enhancement is hardware-related (e.g., a new device backend like Intel XPU, DirectML, Vulkan), please include:
+
+- Vendor + model (e.g., "Intel Arc A770 16 GB" or "Apple M3 Max")
+- Driver / runtime version
+- OS + Python version
+- Whether you have a rig you can use to validate a PR
+
+## Related work
+
+Links to specs, prior issues, PyTorch docs, vendor SDK docs, etc.

cymatix_context-0.8.0/.github/workflows/ci.yml

@@ -0,0 +1,127 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+# Cancel in-progress runs on the same ref so a fast follow-up push
+# doesn't keep a stale run alive.
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test-linux:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install CPU-only torch
+        run: pip install --index-url https://download.pytorch.org/whl/cpu torch
+
+      - name: Install package + test deps
+        run: pip install -e ".[dev]" psutil platformdirs py-cpuinfo numpy joblib scikit-learn
+
+      # Scope: run only the hardware-module test files. The wider unit suite
+      # has pre-existing CI-hostile import-time side effects (server.py:3091
+      # eagerly calls create_app() which sqlite3.connects to a configured
+      # genome path that doesn't exist on a clean runner). Restructuring
+      # server.py for lazy init is out of scope for PR2; tracked as a
+      # follow-up enhancement.
+      - name: Run hardware test suite
+        run: pytest tests/test_hardware.py tests/test_hardware_real_device.py tests/test_hardware_mps_smoke.py -v
+
+  # WS2 review FIX-4: targeted suites for the symbol-graph feature. The full
+  # unit suite is still blocked in CI by server import-time side effects (see
+  # the scope comments below) — this job scopes to the WS2 surface instead:
+  # extraction, pipeline, lifecycle cleanup, flag-off routing, write-lock
+  # integrity, and the config/reference-sync contract. The [ast] extra
+  # installs tree-sitter (+ grammars) so the skipif-marked symbol tests
+  # actually run rather than degrade to skips.
+  test-symbol-graph:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install CPU-only torch
+        run: pip install --index-url https://download.pytorch.org/whl/cpu torch
+
+      - name: Install package + test deps + tree-sitter extra
+        run: pip install -e ".[dev,ast]" psutil platformdirs py-cpuinfo numpy joblib scikit-learn
+
+      - name: Install spaCy model (ingest-path tests exercise the CPU tagger)
+        run: python -m spacy download en_core_web_sm
+
+      - name: Run symbol-graph test suites
+        run: >
+          pytest
+          tests/test_symbol_extraction.py
+          tests/test_symbol_pagerank.py
+          tests/test_symbol_graph_pipeline.py
+          tests/test_symbol_graph_lifecycle.py
+          tests/test_symbol_graph_flag_off.py
+          tests/test_config.py
+          tests/test_config_reference_sync.py
+          tests/test_store_write_integrity.py
+          -v
+
+  test-macos-mps:
+    runs-on: macos-14
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install package + test deps + transformers (for MPS smoke test)
+        run: pip install -e ".[dev]" torch transformers psutil platformdirs py-cpuinfo numpy joblib scikit-learn
+
+      # Scope: run only the hardware-module test files. The MPS smoke test
+      # is the actual integration check this job is for; the wider unit
+      # suite has pre-existing CI-hostile import-time side effects
+      # (server.py:3091) that PR2 isn't supposed to fix.
+      #
+      # PYTORCH_MPS_HIGH_WATERMARK_RATIO=0.0 disables PyTorch's internal MPS
+      # memory ceiling. On the GHA macos-14 runner the default ceiling is
+      # too tight and trips on tiny allocations even when ~7 GiB is free.
+      # This is the documented workaround
+      # (https://pytorch.org/docs/stable/notes/mps.html).
+      - name: Run hardware test suite (MPS smoke test runs only on this job)
+        env:
+          PYTORCH_MPS_HIGH_WATERMARK_RATIO: "0.0"
+        run: pytest tests/test_hardware.py tests/test_hardware_real_device.py tests/test_hardware_mps_smoke.py -v
+
+  test-windows:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install CPU-only torch
+        run: pip install --index-url https://download.pytorch.org/whl/cpu torch
+
+      - name: Install package + test deps
+        run: pip install -e ".[dev]" psutil platformdirs py-cpuinfo numpy joblib scikit-learn
+
+      # Scope: run only the hardware-module test files. The wider unit suite
+      # has pre-existing CI-hostile import-time side effects (server.py:3091
+      # eagerly calls create_app() which sqlite3.connects to a configured
+      # genome path that doesn't exist on a clean runner). Restructuring
+      # server.py for lazy init is out of scope for PR2; tracked as a
+      # follow-up enhancement.
+      - name: Run hardware test suite
+        run: pytest tests/test_hardware.py tests/test_hardware_real_device.py tests/test_hardware_mps_smoke.py -v

cymatix_context-0.8.0/.github/workflows/publish.yml

@@ -0,0 +1,47 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

cymatix_context-0.8.0/.gitignore

@@ -0,0 +1,153 @@
+__pycache__/
+*.pyc
+*.pyo
+.pytest_cache/
+*.egg-info/
+dist/
+build/
+
+# Runtime artifacts
+genome.db
+genome.db-wal
+genome.db-shm
+genome-bench-*.db
+genome_bench_*.db
+genome_bench_*.db-shm
+genome_bench_*.db-wal
+genome_cpu.db
+genome_cpu.db-wal
+genome_cpu.db-shm
+genome.db.pre-*.bak
+genome.db.pre-*.bak-shm
+genome.db.pre-*.bak-wal
+genome_*.db
+genome_*.db-shm
+genome_*.db-wal
+helix.db
+helix.db-shm
+helix.db-wal
+*.SAFETY_COPY
+helix.log
+metrics.json
+overnight_logs/
+logs/
+genomes/
+
+# Benchmark incremental traces (one line per needle)
+benchmarks/*.incremental.jsonl
+# Benchmark monitor traces (per-check heartbeats)
+benchmarks/*.monitor.jsonl
+# Benchmark stdout captures and runtime logs (ephemeral; archive selectively if needed)
+benchmarks/*.log
+benchmarks/*.stdout.log
+
+# IDE workspace state
+.obsidian/
+
+# Visual companion / brainstorming sessions (Claude Code superpowers plugin)
+.superpowers/
+
+# Benchmark logs directory and large result outputs
+benchmarks/logs/
+benchmarks/results/*.json
+
+# Dev scripts not part of the project
+foveated_smoke_*.sh
+# Local benchmark scratch and explicit error outputs
+benchmarks/_fingerprint_*.json
+benchmarks/docs_tidy_diff.md
+benchmarks/docs_tidy_*.json
+benchmarks/*error*.json
+benchmarks/snow/results/*error*.json
+# Benchmark run outputs — regenerable, large, per-run timestamps. If a JSON
+# *should* be tracked (curated fixture, etc.) commit it with `git add -f`
+# or add an explicit exception below.
+benchmarks/*.json
+!benchmarks/fixtures.json
+# #204 SPLADE scale curve: curated paraphrase gold-query fixture + its
+# provenance sidecar (authored, not a regenerable run output).
+!benchmarks/_splade_curve_queries.json
+!benchmarks/_splade_curve_queries.meta.json
+benchmarks/results/*
+!benchmarks/results/faithfulness/
+benchmarks/*_report.txt
+benchmarks/*_report_utf8.txt
+
+# IDE
+.vscode/
+.idea/
+
+# Build
+dist/
+*.egg-info/
+
+# Trained models (users train their own)
+training/models/
+training/data/
+
+# Ingest logs
+deep_ingest*.log
+core_ingest.log
+*_ingest*.log
+
+# Server runtime log (redirected stdout when starting via `python -m helix_context.server > helix_server.log`)
+helix_server.log
+# Catches sharded_server.log, helix_mcpo_server.log, etc. — any *_server.log shape.
+*_server.log
+
+# cwola_log export staging area (scripts/export_cwola_log.py writes here before rclone upload)
+cwola_export/
+
+# Upload tarballs built for R2 delivery (see scripts/ + docs/collab/)
+helix-collab-bundle*.tar.gz
+helix-code-bundle*.tar.gz
+
+# Local scratch + benchmark backups (e.g. helix.toml.bench-backup written by
+# overnight orchestrators while temporarily tuning config for a run).
+temp_*.md
+*.bench-backup
+
+# Per-machine launcher overrides (start-cymatix-tray.local.bat etc. —
+# the checked-in .bat files tell users to copy-and-edit these).
+*.local.bat
+
+# OS
+Thumbs.db
+.DS_Store
+
+# Native observability sidecar — binaries downloaded by the install script.
+tools/native-otel/collector/
+tools/native-otel/prometheus/
+tools/native-otel/tempo/
+tools/native-otel/loki/
+tools/native-otel/grafana/
+# Install-completion sentinel written by scripts/install-native-observability.ps1
+# and consumed (then removed) by the tray's auto-restart watcher.
+tools/native-otel/.install-complete
+# Rendered configs are local to each install (paths embedded reflect the
+# user's home/AppData). Don't commit them.
+tools/native-otel/configs/*.yaml
+tools/native-otel/configs/*.yml
+!tools/native-otel/configs/.gitkeep
+
+# Deep-review working notes — local analysis artifacts (Tier-0 plan,
+# deep-review notes, PR-5 handoff). Not part of the tracked codebase.
+docs/reviews/2026-05-16-deep-review/
+
+# Local data / tool caches (2026-07-01 housekeeping)
+.serena/
+.tmp.driveupload/
+.worktrees/
+runs/
+s2b_*/
+benchmarks/aider_polyglot/
+benchmarks/contextbench/
+*.db-wal
+*.db-shm
+google_doc.*
+
+# Personal/scratch (2026-07-01, supersedes #226)
+.obsidian/
+overnight_logs/
+GEMINI.md
+scripts/.ingest_progress