locus-assistant 1.0.3__tar.gz

locus_assistant-1.0.3/.github/CODEOWNERS

@@ -0,0 +1,16 @@
+# CODEOWNERS — gates which approvals satisfy the "Require review from
+# Code Owners" branch ruleset on `main`.
+#
+# Anyone listed here may approve PRs against the patterns they own.
+# Combined with the matching branch ruleset toggle, only their approvals
+# count toward the merge requirement. Non-owners can still leave reviews
+# and comments; their approvals simply do not unblock merge.
+#
+# See: https://docs.github.com/repositories/managing-your-repositories-settings-and-features/customizing-your-repository/about-code-owners
+#
+# To add more owners, append GitHub handles (`@username`) or team slugs
+# (`@locus/<team>`) to the line below. To gate specific paths
+# differently, add a more-specific pattern beneath it (later, more
+# specific rules win).
+
+* @jonsaadfalcon @ANarayan @robbym-dev

locus_assistant-1.0.3/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,95 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+labels: ["type:bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for reporting a bug! Please fill out the information below to help us investigate.
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear description of what the bug is.
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior.
+      placeholder: |
+        1. Run `locus ask "..."`
+        2. See error...
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened.
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - Linux
+        - macOS
+        - Windows
+    validations:
+      required: true
+  - type: dropdown
+    id: python
+    attributes:
+      label: Python Version
+      options:
+        - "3.10"
+        - "3.11"
+        - "3.12"
+        - "3.13"
+    validations:
+      required: true
+  - type: dropdown
+    id: hardware
+    attributes:
+      label: Hardware
+      options:
+        - NVIDIA GPU
+        - AMD GPU
+        - Apple Silicon
+        - CPU only
+    validations:
+      required: true
+  - type: dropdown
+    id: engine
+    attributes:
+      label: Engine
+      description: Which inference engine are you using?
+      options:
+        - Ollama
+        - vLLM
+        - llama.cpp
+        - SGLang
+        - MLX
+        - Cloud (OpenAI/Anthropic/Google)
+        - LiteLLM
+        - Other
+    validations:
+      required: false
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs / Traceback
+      description: Paste any relevant logs or traceback here.
+      render: shell
+    validations:
+      required: false

locus_assistant-1.0.3/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Ask a Question
+    url: https://github.com/aryanjsx/Locus/discussions
+    about: Use Discussions for questions and help

locus_assistant-1.0.3/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,47 @@
+name: Feature Request
+description: Propose a new feature or enhancement
+labels: ["type:feature"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        For non-trivial changes, please open this issue for discussion before starting a PR. This saves everyone time by catching design issues early.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this solve? Why is this needed?
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe how you'd like this to work.
+    validations:
+      required: true
+  - type: dropdown
+    id: area
+    attributes:
+      label: Primitive Area
+      description: Which part of Locus does this touch?
+      options:
+        - Intelligence
+        - Engine
+        - Agent
+        - Tools
+        - Learning
+        - Evals
+        - Frontend
+        - Channels
+        - Rust
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any alternative solutions or features you've considered.
+    validations:
+      required: false

locus_assistant-1.0.3/.github/ISSUE_TEMPLATE/new_eval.yml

@@ -0,0 +1,63 @@
+name: New Eval Dataset
+description: Propose a new evaluation dataset or benchmark
+labels: ["type:eval"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Adding eval datasets is one of the easiest ways to contribute! Fill out the details below.
+  - type: input
+    id: name
+    attributes:
+      label: Dataset Name
+      placeholder: e.g., HumanEval, GSM8K
+    validations:
+      required: true
+  - type: input
+    id: url
+    attributes:
+      label: URL / Reference
+      description: Link to the dataset or paper.
+      placeholder: https://...
+    validations:
+      required: true
+  - type: checkboxes
+    id: capability
+    attributes:
+      label: What capability does it test?
+      options:
+        - label: Reasoning
+        - label: Math
+        - label: Code
+        - label: Knowledge
+        - label: Multimodal
+        - label: Tool Use
+        - label: Long Context
+        - label: Other
+  - type: input
+    id: size
+    attributes:
+      label: Approximate Size
+      description: Number of examples in the dataset.
+      placeholder: e.g., 500
+    validations:
+      required: false
+  - type: dropdown
+    id: scorer
+    attributes:
+      label: Proposed Scorer Type
+      options:
+        - Exact Match
+        - F1
+        - BLEU
+        - LLM-as-Judge
+        - Custom
+    validations:
+      required: false
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Any other details about this dataset.
+    validations:
+      required: false

locus_assistant-1.0.3/.github/ISSUE_TEMPLATE/pearl_model_validation.yml

@@ -0,0 +1,98 @@
+name: Pearl Model Validation
+description: Track conversion and validation of a Pearl-compatible mining model
+labels: ["type:feature", "area:mining"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this template when promoting a raw Hugging Face model to a
+        Pearl-compatible `pearl-ai/*-pearl` mining model. A model should remain
+        `planned` in Locus until this checklist is complete.
+  - type: input
+    id: raw_model
+    attributes:
+      label: Raw model
+      placeholder: e.g., Qwen/Qwen3.5-9B
+    validations:
+      required: true
+  - type: input
+    id: pearl_model
+    attributes:
+      label: Pearl model artifact
+      placeholder: e.g., pearl-ai/Qwen3.5-9B-pearl
+    validations:
+      required: true
+  - type: dropdown
+    id: target_provider
+    attributes:
+      label: Target provider
+      options:
+        - vllm-pearl
+        - cpu-pearl
+        - apple-mps-pearl
+    validations:
+      required: true
+  - type: textarea
+    id: quantization_recipe
+    attributes:
+      label: Quantization recipe
+      description: Link or paste the recipe used to create the Pearl model artifact.
+      placeholder: |
+        - compressed-tensors config:
+        - 7-bit mining layers:
+        - 8-bit non-mining layers:
+        - calibration data:
+        - SmoothQuant settings:
+    validations:
+      required: true
+  - type: textarea
+    id: hardware
+    attributes:
+      label: Validation hardware
+      placeholder: |
+        - GPU:
+        - VRAM:
+        - driver/CUDA:
+        - Docker image/tag:
+        - Pearl commit/ref:
+    validations:
+      required: true
+  - type: checkboxes
+    id: acceptance
+    attributes:
+      label: Acceptance checks
+      options:
+        - label: Model loads in Pearl's vLLM miner container
+          required: true
+        - label: vLLM registers Pearl's quantization plugin
+          required: true
+        - label: Mining layers use int7 NoisyGEMM
+          required: true
+        - label: Non-mining layers use int8 vanilla Pearl GEMM
+          required: true
+        - label: `locus mine init --model <pearl-model-id>` succeeds
+          required: true
+        - label: `locus mine start` succeeds
+          required: true
+        - label: `locus ask` succeeds through the mining engine
+          required: true
+        - label: `locus mine status` reports gateway/mining metrics
+          required: true
+        - label: `locus mine validate-model --allow-planned` passes
+          required: true
+        - label: Gateway/miner logs show no submission errors
+          required: true
+  - type: textarea
+    id: artifacts
+    attributes:
+      label: Artifacts
+      description: Attach logs, metrics, model config, and command output.
+      placeholder: |
+        - /v1/models output:
+        - `locus mine status` output:
+        - `locus mine validate-model --output` JSON:
+        - gateway metrics excerpt:
+        - miner logs:
+        - PR/commit that flips status to validated:
+    validations:
+      required: true

locus_assistant-1.0.3/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,16 @@
+## What does this PR do?
+
+<!-- Brief description of the change and its motivation -->
+
+## How was this tested?
+
+<!-- Describe tests added or manual testing performed -->
+
+## Checklist
+
+- [ ] Tests pass (`uv run pytest tests/ -v`)
+- [ ] Linter passes (`uv run ruff check src/ tests/`)
+- [ ] Formatter passes (`uv run ruff format --check src/ tests/`)
+- [ ] New/changed public API has docstrings
+- [ ] Follows registry pattern (if adding new component)
+- [ ] Documentation updated (if applicable)

locus_assistant-1.0.3/.github/clone-stats/badge.json

@@ -0,0 +1,7 @@
+{
+  "schemaVersion": 1,
+  "label": "Git Clones",
+  "message": "389,634",
+  "color": "green",
+  "namedLogo": "git"
+}

locus_assistant-1.0.3/.github/clone-stats/clone-data.json

@@ -0,0 +1,222 @@
+{
+  "total_clones": 389634,
+  "last_updated": "2026-10-30T06:12:27Z",
+  "daily": {
+    "2026-03-27": 2189,
+    "2026-03-28": 1874,
+    "2026-03-29": 933,
+    "2026-03-30": 755,
+    "2026-03-31": 872,
+    "2026-04-01": 539,
+    "2026-04-02": 806,
+    "2026-04-03": 1377,
+    "2026-04-04": 678,
+    "2026-04-05": 734,
+    "2026-04-06": 750,
+    "2026-04-07": 813,
+    "2026-04-08": 1280,
+    "2026-04-09": 981,
+    "2026-04-10": 1142,
+    "2026-04-11": 706,
+    "2026-04-12": 813,
+    "2026-04-13": 1058,
+    "2026-04-14": 868,
+    "2026-04-15": 895,
+    "2026-04-16": 889,
+    "2026-04-17": 2341,
+    "2026-04-18": 1487,
+    "2026-04-19": 1339,
+    "2026-04-20": 1428,
+    "2026-04-21": 1216,
+    "2026-04-22": 1768,
+    "2026-04-23": 1050,
+    "2026-04-24": 1245,
+    "2026-04-25": 1116,
+    "2026-04-26": 1211,
+    "2026-04-27": 1606,
+    "2026-04-28": 1090,
+    "2026-04-29": 1332,
+    "2026-04-30": 943,
+    "2026-05-01": 1252,
+    "2026-05-02": 1326,
+    "2026-05-03": 1832,
+    "2026-05-04": 1830,
+    "2026-05-05": 3854,
+    "2026-05-06": 1521,
+    "2026-05-07": 1216,
+    "2026-05-08": 661,
+    "2026-05-09": 796,
+    "2026-05-10": 814,
+    "2026-05-11": 1008,
+    "2026-05-12": 1390,
+    "2026-05-13": 1397,
+    "2026-05-14": 846,
+    "2026-05-15": 1671,
+    "2026-05-16": 2264,
+    "2026-05-17": 654,
+    "2026-05-18": 1425,
+    "2026-05-19": 850,
+    "2026-05-20": 954,
+    "2026-05-21": 1605,
+    "2026-05-22": 612,
+    "2026-05-23": 2437,
+    "2026-05-24": 4900,
+    "2026-05-25": 1319,
+    "2026-05-26": 1199,
+    "2026-05-27": 898,
+    "2026-05-28": 1276,
+    "2026-05-29": 2950,
+    "2026-05-30": 4338,
+    "2026-05-31": 1887,
+    "2026-06-01": 2072,
+    "2026-06-02": 1847,
+    "2026-06-03": 2164,
+    "2026-06-04": 2632,
+    "2026-06-05": 2127,
+    "2026-06-06": 2204,
+    "2026-06-07": 1174,
+    "2026-06-08": 2369,
+    "2026-06-09": 1361,
+    "2026-06-10": 1310,
+    "2026-06-11": 2564,
+    "2026-06-12": 1313,
+    "2026-06-13": 2804,
+    "2026-06-14": 1543,
+    "2026-06-15": 1379,
+    "2026-06-16": 1317,
+    "2026-06-17": 1170,
+    "2026-06-18": 1408,
+    "2026-06-19": 1350,
+    "2026-06-20": 1437,
+    "2026-06-21": 1426,
+    "2026-06-22": 1350,
+    "2026-06-23": 1468,
+    "2026-06-24": 1635,
+    "2026-06-25": 1640,
+    "2026-06-26": 1338,
+    "2026-06-27": 1338,
+    "2026-06-28": 1028,
+    "2026-06-29": 765,
+    "2026-06-30": 951,
+    "2026-07-01": 1134,
+    "2026-07-02": 593,
+    "2026-07-03": 537,
+    "2026-07-04": 411,
+    "2026-07-05": 485,
+    "2026-07-06": 555,
+    "2026-07-07": 905,
+    "2026-07-08": 1171,
+    "2026-07-09": 1857,
+    "2026-07-10": 1181,
+    "2026-07-11": 2185,
+    "2026-07-12": 1917,
+    "2026-07-13": 2102,
+    "2026-07-14": 2337,
+    "2026-07-15": 2362,
+    "2026-07-16": 2497,
+    "2026-07-17": 1773,
+    "2026-07-18": 1542,
+    "2026-07-19": 1445,
+    "2026-07-20": 1481,
+    "2026-07-21": 1528,
+    "2026-07-22": 1529,
+    "2026-07-23": 1209,
+    "2026-07-24": 1118,
+    "2026-07-25": 928,
+    "2026-07-26": 740,
+    "2026-07-27": 799,
+    "2026-07-28": 665,
+    "2026-07-29": 745,
+    "2026-07-30": 591,
+    "2026-07-31": 783,
+    "2026-08-01": 567,
+    "2026-08-02": 1248,
+    "2026-08-03": 724,
+    "2026-08-04": 708,
+    "2026-08-05": 647,
+    "2026-08-06": 604,
+    "2026-08-07": 624,
+    "2026-08-08": 706,
+    "2026-08-09": 1076,
+    "2026-08-10": 1060,
+    "2026-08-11": 2182,
+    "2026-08-12": 641,
+    "2026-08-13": 770,
+    "2026-08-14": 943,
+    "2026-08-15": 1463,
+    "2026-08-16": 1229,
+    "2026-08-17": 714,
+    "2026-08-18": 879,
+    "2026-08-19": 763,
+    "2026-08-20": 10539,
+    "2026-08-21": 3692,
+    "2026-08-22": 2346,
+    "2026-08-23": 1302,
+    "2026-08-24": 2155,
+    "2026-08-25": 1596,
+    "2026-08-26": 1992,
+    "2026-08-27": 1922,
+    "2026-08-28": 1395,
+    "2026-08-29": 1997,
+    "2026-08-30": 2429,
+    "2026-08-31": 4478,
+    "2026-09-01": 1388,
+    "2026-09-02": 2695,
+    "2026-09-03": 787,
+    "2026-09-04": 1416,
+    "2026-09-05": 743,
+    "2026-09-06": 763,
+    "2026-09-07": 1289,
+    "2026-09-08": 794,
+    "2026-09-09": 824,
+    "2026-09-10": 753,
+    "2026-09-11": 838,
+    "2026-09-12": 781,
+    "2026-09-13": 1984,
+    "2026-09-14": 3006,
+    "2026-09-15": 1512,
+    "2026-09-16": 1847,
+    "2026-09-17": 1229,
+    "2026-09-18": 1262,
+    "2026-09-19": 1439,
+    "2026-09-20": 1242,
+    "2026-09-21": 1571,
+    "2026-09-22": 1287,
+    "2026-09-23": 2291,
+    "2026-09-24": 1721,
+    "2026-09-25": 1502,
+    "2026-09-26": 1574,
+    "2026-09-27": 1780,
+    "2026-09-28": 1226,
+    "2026-09-29": 3347,
+    "2026-09-30": 1730,
+    "2026-10-01": 2808,
+    "2026-10-02": 1682,
+    "2026-10-03": 3366,
+    "2026-10-04": 1286,
+    "2026-10-05": 4016,
+    "2026-10-06": 3855,
+    "2026-10-07": 6242,
+    "2026-10-08": 2700,
+    "2026-10-09": 1767,
+    "2026-10-10": 3322,
+    "2026-10-11": 3351,
+    "2026-10-12": 4629,
+    "2026-10-13": 3916,
+    "2026-10-14": 3859,
+    "2026-10-15": 2878,
+    "2026-10-16": 6114,
+    "2026-10-17": 4138,
+    "2026-10-18": 3288,
+    "2026-10-19": 4800,
+    "2026-10-20": 2807,
+    "2026-10-21": 7733,
+    "2026-10-22": 4000,
+    "2026-10-23": 5647,
+    "2026-10-24": 4928,
+    "2026-10-25": 6133,
+    "2026-10-26": 4200,
+    "2026-10-27": 5661,
+    "2026-10-28": 3801
+  }
+}

locus_assistant-1.0.3/.github/dependabot.yml

@@ -0,0 +1,70 @@
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/frontend"
+    open-pull-requests-limit: 2
+    schedule:
+      interval: "weekly"
+    groups:
+      frontend-minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "cargo"
+    directory: "/frontend/src-tauri"
+    open-pull-requests-limit: 2
+    schedule:
+      interval: "weekly"
+    groups:
+      tauri-minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "cargo"
+    directory: "/rust"
+    # Pre-1.0 Rig upgrades change its model/agent APIs and need a migration.
+    ignore:
+      - dependency-name: "rig-core"
+        update-types: ["version-update:semver-major"]
+    open-pull-requests-limit: 2
+    schedule:
+      interval: "weekly"
+    groups:
+      rust-minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "uv"
+    directory: "/"
+    open-pull-requests-limit: 2
+    schedule:
+      interval: "weekly"
+    groups:
+      python-minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    open-pull-requests-limit: 2
+    schedule:
+      interval: "weekly"
+    groups:
+      actions-minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"