Debux v1 fused weights (4-bit MLX, adapter merged into base)

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+tokenizer.json filter=lfs diff=lfs merge=lfs -text

README.md

@@ -1,134 +1,7 @@
 ---
-base_model: Qwen/Qwen3.8-27B
+language: en
 library_name: mlx
 tags:
-  - debugging
-  - devops
-  - sysadmin
-  - linux
-  - lora
-language:
-  - en
-license: apache-2.0
+- mlx
+pipeline_tag: text-generation
 ---
-
-# Debux v1
-
-A debugging assistant for Linux and DevOps problems. You have a broken server, you talk to Debux,
-and it asks you what to run, reads what you paste back, and works out what that output rules in and
-out until it can name a cause or tell you honestly that it cannot.
-
-Debux does not touch your machine. It never executes anything, never holds credentials, and never
-needs SSH on the box that is already on fire. You run the commands, it reads the output. The cost is
-round trips; the benefit is that a debugging tool with no execution path has no blast radius, and
-you see every command before it runs.
-
-v1 is a LoRA over `qwen3.8-27b-4bit`, trained for roughly 80 iterations on 198 hand-authored
-multi-turn rows.
-
-## What it fixes, and what it breaks
-
-The stock base model is, almost exactly, the degenerate strategy of never committing to anything:
-it answers "run one more command" to nearly every input, including when the evidence it is asking
-for was never recorded and cannot be produced. On a 73-item held-out benchmark it scores 25.3
-percent balanced accuracy against a 25 percent floor.
-
-v1 substantially fixes that, and introduces a new problem in the process. Both are reported here
-because the second one matters if you are going to rely on this.
-
-| | base | **v1** |
-|---|---|---|
-| balanced accuracy | 25.3% | **32.0%** |
-| DIAGNOSIS recall | 3/21 = 14.3% | **10/21 = 47.6%** |
-| reply with no parseable directive | 14/73 = 19.2% | **1/73 = 1.4%** |
-| NEED recall | 40/46 = 87.0% | 37/46 = 80.4% |
-| INSUFFICIENT recall | 0/4 | 0/4 |
-| SEARCH recall | 0/2 | 0/2 |
-| overclaim rate | 0/4 | **1/4** |
-
-**The gain is real.** DIAGNOSIS recall more than tripled, and the Wilson intervals barely overlap
-([5-35%] against [28-68%]), so on 21 items this is not noise. Format compliance went from 14 missing
-directives to 1.
-
-**The regression is also real, and it is the one to watch.** Eight NEED items are now answered
-DIAGNOSIS - cases where the model should have asked for more evidence and instead named a cause.
-The base did this zero times. We traded some under-commitment for some over-commitment and came out
-ahead on balance, but a debugging assistant that names causes early sends someone to restart the
-wrong service at 3am, so this is a genuine cost and not a rounding error.
-
-**INSUFFICIENT and SEARCH did not move at all** (0/4 and 0/2). Those are the two hardest classes and
-the two smallest, so "not learned in 80 iterations" and "not measurable at n=4" cannot be told apart
-from this data. Do not read the zeros as evidence either way.
-
-## The format is a contract
-
-Every reply is reasoning followed by exactly one directive. The client parses the directive and acts
-on it, so this is an interface rather than a writing style.
-
-```
-REASONING:
-- errno 111 is connection refused: the address is reachable, nothing is accepting on it
-- ss confirms it, only nginx and sshd are listening
-- nginx config is not implicated; the application behind it is not running
-NEED:
-  systemctl list-units --type=service --state=failed
-  journalctl -u <your-app> -n 40 --no-pager
-```
-
-| directive | when | client behaviour |
-|---|---|---|
-| `NEED` | more evidence is needed and a command here will produce it | shows the commands, waits for pasted output |
-| `DIAGNOSIS` | the evidence identifies the cause | prints the cause and a `FIX:` block |
-| `SEARCH` | the gap is a version- or vendor-specific fact | runs the query, feeds results back |
-| `INSUFFICIENT` | you want a cause and the evidence cannot support one | prints what is missing and what would settle it |
-
-`NEED` versus `INSUFFICIENT` is the distinction the model exists for. `NEED` means the answer is on
-the machine and a command will fetch it. `INSUFFICIENT` means it is not: the record was never
-written, it was rotated away, it lives with a vendor or a hypervisor, or it needs measurement over
-time that nobody started. Telling someone to keep looking at a machine that does not hold the answer
-wastes an outage.
-
-## Using it
-
-Two things are required, or the directive contract is not reliable:
-
-1. **Use the shipped system prompt** (`system_prompt.txt`). It is short by necessity and the model
-   was trained against it exactly.
-2. **Window the history.** The model was trained on the system prompt, the original symptom, and the
-   last message only - never a full transcript. Feeding it the whole conversation is a context shape
-   it has never seen. The reference client does this in one function.
-3. **Turn thinking off.** This base has a thinking mode, and with it enabled the model emits a
-   planning monologue before the format and frequently runs out of tokens mid-answer. Pass
-   `enable_thinking=False` to `apply_chat_template`, or the equivalent for your server. The training
-   corpus contains no think blocks, so the reasoning belongs in the visible answer.
-
-Reasoning is visible rather than hidden in `<think>` blocks. That was settled by measurement earlier
-in this line of work: a sibling model trained on a corpus with no think blocks got *worse* with
-thinking enabled, recall falling from 86.5 to 68.3 percent, and the base with thinking on did not
-converge at all. For a debugging tool it is also the better product, since someone staring at a
-broken server needs to see why they are being asked to run something.
-
-## Training
-
-LoRA, rank 32, 16 layers, learning rate 1e-5, gradient checkpointing, loss masked to the assistant
-message only.
-
-That last point matters: the pasted command output in the corpus is synthetic, and without masking
-the model would spend capacity learning to generate convincing `df` and `journalctl` output, which
-is a direct route to inventing evidence in a tool whose only job is reading real evidence.
-
-Rows are multi-turn. A sibling model trained on a single-turn corpus loops when placed in an actual
-conversation.
-
-## Honest limits
-
-- **80 iterations.** This is an early checkpoint, stopped deliberately rather than trained to
-  convergence. A longer run is the obvious next step and may or may not help the overclaiming.
-- **Never tested against a real machine.** Every command output in the training corpus was written,
-  not captured. A harness that runs the model against deliberately broken Docker containers exists
-  for exactly this reason, and it has not been run yet. Until it has, treat the benchmark numbers as
-  measuring behaviour on one house style of terminal output.
-- **Small benchmark.** 73 items over 25 held-out scenarios. INSUFFICIENT is 4 items and SEARCH is 2.
-- **Linux server work only.** No Windows, no macOS, no embedded.
-- **It can be wrong.** It is a way to be systematic about evidence under pressure, not a replacement
-  for someone who knows the system.

chat_template.jinja

@@ -0,0 +1,170 @@
+{%- set image_count = namespace(value=0) %}
+{%- set video_count = namespace(value=0) %}
+{%- macro render_content(content, do_vision_count, is_system_content=false) %}
+    {%- if content is string %}
+        {{- content }}
+    {%- elif content is iterable and content is not mapping %}
+        {%- for item in content %}
+            {%- if 'image' in item or 'image_url' in item or item.type == 'image' %}
+                {%- if is_system_content %}
+                    {{- raise_exception('System message cannot contain images.') }}
+                {%- endif %}
+                {%- if do_vision_count %}
+                    {%- set image_count.value = image_count.value + 1 %}
+                {%- endif %}
+                {%- if add_vision_id %}
+                    {{- 'Picture ' ~ image_count.value ~ ': ' }}
+                {%- endif %}
+                {{- '<|vision_start|><|image_pad|><|vision_end|>' }}
+            {%- elif 'video' in item or item.type == 'video' %}
+                {%- if is_system_content %}
+                    {{- raise_exception('System message cannot contain videos.') }}
+                {%- endif %}
+                {%- if do_vision_count %}
+                    {%- set video_count.value = video_count.value + 1 %}
+                {%- endif %}
+                {%- if add_vision_id %}
+                    {{- 'Video ' ~ video_count.value ~ ': ' }}
+                {%- endif %}
+                {{- '<|vision_start|><|video_pad|><|vision_end|>' }}
+            {%- elif 'text' in item %}
+                {{- item.text }}
+            {%- else %}
+                {{- raise_exception('Unexpected item type in content.') }}
+            {%- endif %}
+        {%- endfor %}
+    {%- elif content is none or content is undefined %}
+        {{- '' }}
+    {%- else %}
+        {{- raise_exception('Unexpected content type.') }}
+    {%- endif %}
+{%- endmacro %}
+{%- if not messages %}
+    {{- raise_exception('No messages provided.') }}
+{%- endif %}
+{%- set reasoning_instructions = '' %}
+{%- if enable_thinking is undefined or enable_thinking is true %}
+    {%- set resolved_reasoning_effort = reasoning_effort|default('xhigh') %}
+    {%- if resolved_reasoning_effort not in ('xhigh', 'medium', 'low') %}
+        {{- raise_exception('Unexpected reasoning effort ' ~ reasoning_effort ~ '. Supported types are xhigh (default), medium, and low.') }}
+    {%- endif %}
+    {%- if resolved_reasoning_effort == 'xhigh' %}
+        {%- set reasoning_instructions = 'Reasoning effort is set to xhigh. Please think carefully through the task, validate key assumptions, consider plausible alternatives, and prioritize correctness, consistency, and clarity in the final answer.' %}
+    {%- elif resolved_reasoning_effort == 'low' %}
+        {%- set reasoning_instructions = 'Reasoning effort is set to low. Keep your thinking brief and focused, moving directly to the conclusion without unnecessary elaboration.' %}
+    {%- endif %}
+{%- endif %}
+{%- if tools and tools is iterable and tools is not mapping %}
+    {{- '<|im_start|>system\n' }}
+    {%- if reasoning_instructions %}
+        {{- reasoning_instructions + '\n\n' }}
+    {%- endif %}
+    {{- "# Tools\n\nYou have access to the following functions:\n\n<tools>" }}
+    {%- for tool in tools %}
+        {{- "\n" }}
+        {{- tool | tojson }}
+    {%- endfor %}
+    {{- "\n</tools>" }}
+    {{- '\n\nIf you choose to call a function ONLY reply in the following format with NO suffix:\n\n<tool_call>\n<function=example_function_name>\n<parameter=example_parameter_1>\nvalue_1\n</parameter>\n<parameter=example_parameter_2>\nThis is the value for the second parameter\nthat can span\nmultiple lines\n</parameter>\n</function>\n</tool_call>\n\n<IMPORTANT>\nReminder:\n- Function calls MUST follow the specified format: an inner <function=...></function> block must be nested within <tool_call></tool_call> XML tags\n- Required parameters MUST be specified\n- You may provide optional reasoning for your function call in natural language BEFORE the function call, but NOT after\n- If there is no function call available, answer the question like normal with your current knowledge and do not tell the user about function calls\n</IMPORTANT>' }}
+    {%- if messages[0].role == 'system' %}
+        {%- set content = render_content(messages[0].content, false, true)|trim %}
+        {%- if content %}
+            {{- '\n\n' + content }}
+        {%- endif %}
+    {%- endif %}
+    {{- '<|im_end|>\n' }}
+{%- else %}
+    {%- if messages[0].role == 'system' %}
+        {%- set content = render_content(messages[0].content, false, true)|trim %}
+        {%- if content %}
+            {{- '<|im_start|>system\n' + (reasoning_instructions + '\n\n' if reasoning_instructions else '')  + content + '<|im_end|>\n' }}
+        {%- elif reasoning_instructions %}
+            {{- '<|im_start|>system\n' + reasoning_instructions + '<|im_end|>\n' }}
+        {%- endif %}
+    {%- elif reasoning_instructions %}
+        {{- '<|im_start|>system\n' + reasoning_instructions + '<|im_end|>\n' }}
+    {%- endif %}
+{%- endif %}
+{%- set ns = namespace(multi_step_tool=true, last_query_index=messages|length - 1) %}
+{%- for message in messages[::-1] %}
+    {%- set index = (messages|length - 1) - loop.index0 %}
+    {%- if ns.multi_step_tool and message.role == "user" %}
+        {%- set content = render_content(message.content, false)|trim %}
+        {%- if not(content.startswith('<tool_response>') and content.endswith('</tool_response>')) %}
+            {%- set ns.multi_step_tool = false %}
+            {%- set ns.last_query_index = index %}
+        {%- endif %}
+    {%- endif %}
+{%- endfor %}
+{%- if ns.multi_step_tool %}
+    {{- raise_exception('No user query found in messages.') }}
+{%- endif %}
+{%- for message in messages %}
+    {%- set content = render_content(message.content, true)|trim %}
+    {%- if message.role == "system" %}
+        {%- if not loop.first %}
+            {{- raise_exception('System message must be at the beginning.') }}
+        {%- endif %}
+    {%- elif message.role == "user" %}
+        {{- '<|im_start|>' + message.role + '\n' + content + '<|im_end|>' + '\n' }}
+    {%- elif message.role == "assistant" %}
+        {%- set reasoning_content = '' %}
+        {%- if message.reasoning_content is string %}
+            {%- set reasoning_content = message.reasoning_content %}
+        {%- endif %}
+        {%- set reasoning_content = reasoning_content|trim %}
+        {%- if preserve_thinking is undefined or preserve_thinking is true or loop.index0 > ns.last_query_index %}
+            {{- '<|im_start|>' + message.role + '\n<think>\n' + reasoning_content + '\n</think>\n\n' + content }}
+        {%- else %}
+            {{- '<|im_start|>' + message.role + '\n' + content }}
+        {%- endif %}
+        {%- if message.tool_calls and message.tool_calls is iterable and message.tool_calls is not mapping %}
+            {%- for tool_call in message.tool_calls %}
+                {%- if tool_call.function is defined %}
+                    {%- set tool_call = tool_call.function %}
+                {%- endif %}
+                {%- if loop.first %}
+                    {%- if content|trim %}
+                        {{- '\n\n<tool_call>\n<function=' + tool_call.name + '>\n' }}
+                    {%- else %}
+                        {{- '<tool_call>\n<function=' + tool_call.name + '>\n' }}
+                    {%- endif %}
+                {%- else %}
+                    {{- '\n<tool_call>\n<function=' + tool_call.name + '>\n' }}
+                {%- endif %}
+                {%- if tool_call.arguments is defined and tool_call.arguments != '' %}
+                    {%- for args_name, args_value in tool_call.arguments|items %}
+                        {{- '<parameter=' + args_name + '>\n' }}
+                        {%- set args_value = args_value | string if args_value is string else args_value | tojson | safe %}
+                        {{- args_value }}
+                        {{- '\n</parameter>\n' }}
+                    {%- endfor %}
+                {%- endif %}
+                {{- '</function>\n</tool_call>' }}
+            {%- endfor %}
+        {%- endif %}
+        {{- '<|im_end|>\n' }}
+    {%- elif message.role == "tool" %}
+        {%- if loop.previtem and loop.previtem.role != "tool" %}
+            {{- '<|im_start|>user' }}
+        {%- endif %}
+        {{- '\n<tool_response>\n' }}
+        {{- content }}
+        {{- '\n</tool_response>' }}
+        {%- if not loop.last and loop.nextitem.role != "tool" %}
+            {{- '<|im_end|>\n' }}
+        {%- elif loop.last %}
+            {{- '<|im_end|>\n' }}
+        {%- endif %}
+    {%- else %}
+        {{- raise_exception('Unexpected message role.') }}
+    {%- endif %}
+{%- endfor %}
+{%- if add_generation_prompt %}
+    {{- '<|im_start|>assistant\n' }}
+    {%- if enable_thinking is defined and enable_thinking is false %}
+        {{- '<think>\n\n</think>\n\n' }}
+    {%- else %}
+        {{- '<think>\n' }}
+    {%- endif %}
+{%- endif %}

config.json

@@ -0,0 +1,154 @@
+{
+    "architectures": [
+        "Qwen3_5ForConditionalGeneration"
+    ],
+    "do_sample": true,
+    "eos_token_id": [
+        248046,
+        248044
+    ],
+    "generation_config": {
+        "bos_token_id": 248044,
+        "do_sample": true,
+        "eos_token_id": [
+            248046,
+            248044
+        ],
+        "pad_token_id": 248044,
+        "temperature": 1.0,
+        "top_k": 20,
+        "top_p": 0.95
+    },
+    "image_token_id": 248056,
+    "language_model_only": false,
+    "model_type": "qwen3_5",
+    "quantization": {
+        "group_size": 64,
+        "bits": 4,
+        "mode": "affine"
+    },
+    "quantization_config": {
+        "group_size": 64,
+        "bits": 4,
+        "mode": "affine"
+    },
+    "temperature": 1.0,
+    "text_config": {
+        "attention_bias": false,
+        "attention_dropout": 0.0,
+        "attn_output_gate": true,
+        "bos_token_id": 248044,
+        "dtype": "bfloat16",
+        "eos_token_id": 248044,
+        "full_attention_interval": 4,
+        "head_dim": 256,
+        "hidden_act": "silu",
+        "hidden_size": 5120,
+        "initializer_range": 0.02,
+        "intermediate_size": 17408,
+        "layer_types": [
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention",
+            "linear_attention",
+            "linear_attention",
+            "linear_attention",
+            "full_attention"
+        ],
+        "linear_conv_kernel_dim": 4,
+        "linear_key_head_dim": 128,
+        "linear_num_key_heads": 16,
+        "linear_num_value_heads": 48,
+        "linear_value_head_dim": 128,
+        "mamba_ssm_dtype": "float32",
+        "max_position_embeddings": 262144,
+        "model_type": "qwen3_5_text",
+        "mtp_num_hidden_layers": 1,
+        "mtp_use_dedicated_embeddings": false,
+        "num_attention_heads": 24,
+        "num_hidden_layers": 64,
+        "num_key_value_heads": 4,
+        "output_gate_type": "swish",
+        "pad_token_id": null,
+        "partial_rotary_factor": 0.25,
+        "rms_norm_eps": 1e-06,
+        "rope_parameters": {
+            "mrope_interleaved": true,
+            "mrope_section": [
+                11,
+                11,
+                10
+            ],
+            "partial_rotary_factor": 0.25,
+            "rope_theta": 10000000,
+            "type": "default"
+        },
+        "tie_word_embeddings": false,
+        "use_cache": true,
+        "vocab_size": 248320
+    },
+    "tie_word_embeddings": false,
+    "top_k": 20,
+    "top_p": 0.95,
+    "transformers_version": "5.8.0.dev0",
+    "video_token_id": 248057,
+    "vision_end_token_id": 248054,
+    "vision_start_token_id": 248053
+}

generation_config.json

@@ -0,0 +1,12 @@
+{
+    "bos_token_id": 248044,
+    "do_sample": true,
+    "eos_token_id": [
+        248046,
+        248044
+    ],
+    "pad_token_id": 248044,
+    "temperature": 1.0,
+    "top_k": 20,
+    "top_p": 0.95
+}

model-00001-of-00003.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:075eac5fbba3951bc4870c1ac65d684c32e0abb24284201bd27f49df56735963
+size 5328325648

model-00002-of-00003.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6c99c446987a432beb1f6ef7d6fde6db02682f1ebe1a913760953140e0fa4e47
+size 5354185130

model-00003-of-00003.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:68f5cf98dd7ffdf36bb2f42a04e54b11b5bce07836acf062b0b05f607fb27f57
+size 4450532735

tokenizer.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:06b9509352d2af50381ab2247e083b80d32d5c0aba91c272ca9ff729b6a0e523
+size 19989325

tokenizer_config.json

@@ -0,0 +1,34 @@
+{
+  "add_prefix_space": false,
+  "audio_bos_token": "<|audio_start|>",
+  "audio_eos_token": "<|audio_end|>",
+  "audio_token": "<|audio_pad|>",
+  "backend": "tokenizers",
+  "bos_token": null,
+  "clean_up_tokenization_spaces": false,
+  "eos_token": "<|im_end|>",
+  "errors": "replace",
+  "image_token": "<|image_pad|>",
+  "is_local": true,
+  "local_files_only": false,
+  "model_max_length": 262144,
+  "model_specific_special_tokens": {
+    "audio_bos_token": "<|audio_start|>",
+    "audio_eos_token": "<|audio_end|>",
+    "audio_token": "<|audio_pad|>",
+    "image_token": "<|image_pad|>",
+    "video_token": "<|video_pad|>",
+    "vision_bos_token": "<|vision_start|>",
+    "vision_eos_token": "<|vision_end|>"
+  },
+  "pad_token": "<|endoftext|>",
+  "pretokenize_regex": "(?i:'s|'t|'re|'ve|'m|'ll|'d)|[^\\r\\n\\p{L}\\p{N}]?[\\p{L}\\p{M}]+|\\p{N}| ?[^\\s\\p{L}\\p{M}\\p{N}]+[\\r\\n]*|\\s*[\\r\\n]+|\\s+(?!\\S)|\\s+",
+  "processor_class": "Qwen3VLProcessor",
+  "split_special_tokens": false,
+  "tokenizer_class": "Qwen2Tokenizer",
+  "tool_parser_type": "qwen3_coder",
+  "unk_token": null,
+  "video_token": "<|video_pad|>",
+  "vision_bos_token": "<|vision_start|>",
+  "vision_eos_token": "<|vision_end|>"
+}