@neurodock/cli 0.8.1 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # @neurodock/cli changelog
 
+## 0.9.0
+
+### Minor Changes
+
+- 1c76c2c: add `neurodock install-skills` and bundle the per-neurotype skills into the cli
+
+  the cli now ships the six per-neurotype skills (their `SKILL.md` files,
+  generated into `dist/assets/skills/` at build time from `packages/skills/`).
+  the new `neurodock install-skills` command copies them into the client's
+  personal skills directory (`~/.claude/skills/neurodock-<name>/` for claude code
+  and claude desktop; cursor is skipped). it supports `--client`, `--dry-run`,
+  and `--yes`, and is idempotent.
+
+  `install-all`, `setup`, and `update` now install the skills as part of the
+  one-command happy path; opt out with `--no-skills` (mirrors `--no-native-host`).
+  the skills step is best-effort — a failure warns but does not fail the command.
+
+## 0.8.2
+
+### Patch Changes
+
+- a7c3f01: fix(native-host): register the real published extension ids so the extension can connect
+
+  The native-messaging host was registered with the literal placeholder
+  `__NEURODOCK_EXTENSION_ID__`, which was never substituted — so the host
+  manifest's `allowed_origins` matched no extension and the browser
+  extension always showed "Not connected yet" even after a successful
+  `setup`/`install-all`.
+
+  - The published Chrome Web Store id (`lcdaiekokkgniiknejddojkfkoiinopo`)
+    and the Firefox gecko id (`neurodock-extension@neurodock.org`) are now
+    the registered defaults (`PUBLISHED_EXTENSION_IDS` /
+    `withDefaultExtensionIds` in `@neurodock/native-host`), so a
+    store-installed extension connects out of the box.
+  - `neurodock setup` and `neurodock install-all` gained a repeatable
+    `--extension-id <id>` flag, threaded down to the host installer, so a
+    locally-loaded unpacked build (whose id differs from the published one)
+    can be allowed in one command. Provided ids are unioned with the
+    published defaults and deduped.
+
+- Updated dependencies [a7c3f01]
+  - @neurodock/native-host@0.2.1
+
 ## 0.8.1
 
 ### Patch Changes

package/README.md

@@ -2,7 +2,7 @@
 
 The `neurodock` installer and diagnostic CLI for [NeuroDock](https://neurodock.org/) — a local-first cognitive substrate for neurodivergent professionals.
 
-Status: **v0.6.2**.
+Status: **v0.8.2**.
 
 ## Quickstart
 
@@ -34,8 +34,9 @@ install, `install-all` runs the `pip install` step automatically.
 
 | Command                      | What it does                                                                                                                                                    |
 | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `neurodock install-all`      | One-command first-time install: pip-install the six servers, wire every detected client, copy the starter profile.                                              |
+| `neurodock install-all`      | One-command first-time install: pip-install the six servers, wire every detected client, copy the starter profile, install the per-neurotype skills.            |
 | `neurodock init`             | Install MCP servers into Claude Desktop / Claude Code / Cursor (the wiring half of `install-all`).                                                              |
+| `neurodock install-skills`   | Copy the per-neurotype skills into your client's personal skills directory (`~/.claude/skills` for Claude Code / Claude Desktop). Cursor is skipped.            |
 | `neurodock doctor`           | Diagnose your install — profile validity, client wiring, tool availability.                                                                                     |
 | `neurodock validate`         | Schema-validate a profile file (`~/.neurodock/profile.yaml` by default).                                                                                        |
 | `neurodock update`           | Upgrade NeuroDock to the latest version — re-installs the six MCP servers via pip/uv and re-wires client configs.                                               |
@@ -60,16 +61,47 @@ install, `install-all` runs the `pip install` step automatically.
 neurodock install-all [--client=claude-desktop|claude-code|cursor|all] \
                       [--profile=minimal|example] \
                       [--installer=uv|pip|auto] \
-                      [--skip-install] [--yes] [--dry-run]
+                      [--skip-install] [--yes] [--dry-run] \
+                      [--no-native-host] [--no-skills]
 ```
 
 Single-command first-time install. Prefers `uv` if it is on PATH; falls
 back to `python -m pip`. After install, verifies each server entrypoint
-is on PATH with `<command> --help`, then delegates to `init` to wire
-clients.
+is on PATH with `<command> --help`, delegates to `init` to wire clients,
+registers the optional native-messaging host, and installs the
+per-neurotype skills into `~/.claude/skills`.
 
-Exit codes: `0` ok, `1` an entrypoint is missing from PATH after
-install, `2` init failed.
+- `--no-native-host` skips registering the native-messaging host.
+- `--no-skills` skips copying the per-neurotype skills.
+
+Both steps are best-effort: a failure in either emits a warning but does
+not fail the command (the six MCP servers are the core). Exit codes:
+`0` ok, `1` an entrypoint is missing from PATH after install, `2` init
+failed.
+
+### `neurodock install-skills`
+
+```
+neurodock install-skills [--client=claude-desktop|claude-code|cursor|all] \
+                         [--dry-run] [--yes]
+```
+
+Copies the six per-neurotype skills bundled in the CLI tarball into the
+client's personal skills directory so Claude Code / Claude Desktop
+discover them. Each skill installs as
+`~/.claude/skills/neurodock-<name>/SKILL.md` (namespaced so it is
+collision-free and recognisably NeuroDock's).
+
+- Claude Code and Claude Desktop share `~/.claude/skills`; the command
+  de-duplicates so the files are written once.
+- Cursor has no skills system today and is skipped with a notice (never
+  an error).
+- `--dry-run` prints the planned targets and exits 0 without writing.
+- Idempotent: re-running refreshes each `SKILL.md` in place.
+
+This is also run automatically by `install-all` / `setup` / `update`
+unless you pass `--no-skills`. Exit codes: `0` ok, `1` no bundled skills
+were found (a packaging bug).
 
 ### `neurodock init`
 
@@ -100,14 +132,16 @@ key are skipped unless `--yes` is supplied.
 neurodock update [--client=claude-desktop|claude-code|cursor|all] \
                  [--profile=minimal|example] \
                  [--installer=uv|pip|auto] \
-                 [--skip-install] [--yes] [--dry-run] [--no-native-host]
+                 [--skip-install] [--yes] [--dry-run] \
+                 [--no-native-host] [--no-skills]
 ```
 
 One-command upgrade. Same code path as `install-all` — re-runs
 `pip install --upgrade` (or `uv tool install`) for every NeuroDock MCP
-server, re-wires the detected MCP clients, and re-registers the
-optional native-messaging host. Exit codes match `install-all`:
-`0` ok, `1` an entrypoint is missing from PATH, `2` init failed.
+server, re-wires the detected MCP clients, re-registers the optional
+native-messaging host, and refreshes the per-neurotype skills (skip with
+`--no-skills`). Exit codes match `install-all`: `0` ok, `1` an
+entrypoint is missing from PATH, `2` init failed.
 
 ### `neurodock sync`
 

package/dist/assets/hooks/proactive_guardrail.py

@@ -174,9 +174,7 @@ def _on_session_start(_payload: dict[str, Any], settings: dict[str, Any]) -> Non
     state["tool_count"] = 0
     _save_session(state)
     band = _clock_band(now)
-    break_minutes = settings.get(
-        "hyperfocus_break_minutes", HYPERFOCUS_BREAK_MINUTES_DEFAULT
-    )
+    break_minutes = settings.get("hyperfocus_break_minutes", HYPERFOCUS_BREAK_MINUTES_DEFAULT)
     if band in ("deep_night", "late_night"):
         _emit_banner(
             f"NeuroDock: it's {band.replace('_', ' ')} local time. "
@@ -208,17 +206,13 @@ def _on_pre_tool(payload: dict[str, Any], settings: dict[str, Any]) -> None:
     if state["tool_count"] % PRETOOL_CHECK_EVERY_N != 0:
         return
 
-    break_minutes = settings.get(
-        "hyperfocus_break_minutes", HYPERFOCUS_BREAK_MINUTES_DEFAULT
-    )
+    break_minutes = settings.get("hyperfocus_break_minutes", HYPERFOCUS_BREAK_MINUTES_DEFAULT)
     end_of_day = settings.get("end_of_day_local")
     hyperfocus_banner = _evaluate_hyperfocus(state, break_minutes, end_of_day)
     if hyperfocus_banner:
         _emit_banner(hyperfocus_banner)
     threshold = settings.get("rumination_threshold", RUMINATION_THRESHOLD_DEFAULT)
-    window = settings.get(
-        "rumination_window_minutes", RUMINATION_WINDOW_MINUTES_DEFAULT
-    )
+    window = settings.get("rumination_window_minutes", RUMINATION_WINDOW_MINUTES_DEFAULT)
     rumination_banner = _evaluate_rumination(threshold, window)
     if rumination_banner:
         _emit_banner(rumination_banner)
@@ -518,7 +512,7 @@ def _is_past_end_of_day(now: datetime, end_of_day_local: str | None) -> bool:
     hour, minute = int(match.group(1)), int(match.group(2))
     if not (0 <= hour <= 23 and 0 <= minute <= 59):
         return _clock_band(now) in ("late_night", "deep_night")
-    # Deep night (00:00–05:59) is always "past end of day" regardless of the
+    # Deep night (00:00-05:59) is always "past end of day" regardless of the
     # configured clock-out — nobody sets end_of_day to 03:00 and means it.
     if now.hour < 6:
         return True
@@ -576,21 +570,15 @@ def _parse_profile_text(text: str) -> dict[str, Any]:
 
     hyperfocus = _extract_int(text, "hyperfocus_break_minutes")
     if hyperfocus is not None:
-        settings["hyperfocus_break_minutes"] = _clamp(
-            hyperfocus, *HYPERFOCUS_BREAK_MIN_RANGE
-        )
+        settings["hyperfocus_break_minutes"] = _clamp(hyperfocus, *HYPERFOCUS_BREAK_MIN_RANGE)
 
     threshold = _extract_int(text, "rumination_threshold")
     if threshold is not None:
-        settings["rumination_threshold"] = _clamp(
-            threshold, *RUMINATION_THRESHOLD_RANGE
-        )
+        settings["rumination_threshold"] = _clamp(threshold, *RUMINATION_THRESHOLD_RANGE)
 
     window = _extract_int(text, "rumination_window_minutes")
     if window is not None:
-        settings["rumination_window_minutes"] = _clamp(
-            window, *RUMINATION_WINDOW_RANGE
-        )
+        settings["rumination_window_minutes"] = _clamp(window, *RUMINATION_WINDOW_RANGE)
 
     eod = _extract_str(text, "end_of_day_local")
     if eod is not None and re.match(r"^\d{1,2}:\d{2}$", eod):
@@ -805,15 +793,15 @@ def _self_test() -> int:
 
     # Profile parsing: extract scalars from a representative profile snippet.
     sample_profile = (
-        "schema_version: \"0.1.0\"\n"
+        'schema_version: "0.1.0"\n'
         "chronometric:\n"
         "  # how long before a nudge\n"
         "  hyperfocus_break_minutes: 60\n"
-        "  end_of_day_local: \"18:30\"\n"
+        '  end_of_day_local: "18:30"\n'
         "guardrails:\n"
         "  rumination_threshold: 4\n"
         "  rumination_window_minutes: 120\n"
-        "  sycophancy_check: \"off\"\n"
+        '  sycophancy_check: "off"\n'
     )
     parsed = _parse_profile_text(sample_profile)
     expected = {
@@ -834,7 +822,7 @@ def _self_test() -> int:
         ok = False
 
     # Profile parsing: an empty / commented profile yields no overrides.
-    if _parse_profile_text("# just a comment\nschema_version: \"0.1.0\"\n") != {}:
+    if _parse_profile_text('# just a comment\nschema_version: "0.1.0"\n') != {}:
         sys.stderr.write("FAIL: bare profile should yield no overrides\n")
         ok = False
 

package/dist/assets/schemas/neurotype-addenda.schema.json

@@ -0,0 +1,167 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.neurodock.org/neurotype-addenda/v1/neurotype-addenda.schema.json",
+  "title": "NeuroDock Neurotype Addenda Artifact",
+  "description": "Validates the language-neutral, enum-keyed prompt-shaping content artifact (data/neurotype-addenda/v1.json). This artifact is CONTENT, not schema shape (ADR 0011): it carries the per-(tool x neurotype) prose blocks that NeuroDock surfaces append to a model prompt, plus the fusion rule, priority ordering, framing, output-format guidance, and the cross-cutting voice-input / tourette / other / generic-fallback blocks. Additive-only versioning: new tools, new neurotypes, and new optional top-level keys are non-breaking. Unknown keys are permitted for forward-compatibility where appropriate.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "artifact_version",
+    "fusion",
+    "priority",
+    "framing",
+    "output_format",
+    "voice_input",
+    "tourette",
+    "other",
+    "generic",
+    "tools"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Optional pointer back to this schema's $id."
+    },
+    "artifact_version": {
+      "type": "string",
+      "description": "Semantic version of the artifact content. Additive changes bump minor; a breaking re-shape forks to a new vN.json + a new schema $id.",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "examples": ["1.0.0"]
+    },
+    "description": {
+      "type": "string"
+    },
+    "tokens": {
+      "type": "array",
+      "description": "The complete set of interpolation tokens any block may contain. Documentation only; the assembler is the authority.",
+      "items": { "type": "string" }
+    },
+    "fusion": {
+      "type": "object",
+      "description": "The AuDHD substitution rule. When the input set lists the `result` neurotype directly, OR lists every neurotype in `all_of`, the `result` block is substituted and every neurotype in `remove` is dropped.",
+      "additionalProperties": true,
+      "required": ["result", "all_of", "remove"],
+      "properties": {
+        "description": { "type": "string" },
+        "result": { "type": "string" },
+        "any_of": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "all_of": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "remove": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "priority": {
+      "type": "array",
+      "description": "Neurotype ordering. Higher-priority addenda are placed LATER in the assembled prompt (recency bias). Neurotypes are sorted by their index in this list.",
+      "items": { "type": "string" },
+      "minItems": 1
+    },
+    "framing": {
+      "type": "object",
+      "description": "The wrapper, header, footer, separators, and conflict footer that surround the per-neurotype blocks.",
+      "additionalProperties": true,
+      "required": [
+        "wrapper_prefix",
+        "wrapper_suffix",
+        "section_separator",
+        "block_line_separator",
+        "header",
+        "footer",
+        "conflict_footer_min_neurotypes",
+        "conflict_footer"
+      ],
+      "properties": {
+        "wrapper_prefix": { "type": "string" },
+        "wrapper_suffix": { "type": "string" },
+        "section_separator": { "type": "string" },
+        "block_line_separator": { "type": "string" },
+        "header": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "footer": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "conflict_footer_min_neurotypes": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "conflict_footer": { "type": "string" }
+      }
+    },
+    "output_format": {
+      "type": "object",
+      "description": "Per-output-format guidance. The assembler renders `prefix + format + separator + descriptions[format]`.",
+      "additionalProperties": true,
+      "required": ["prefix", "separator", "descriptions", "default"],
+      "properties": {
+        "prefix": { "type": "string" },
+        "separator": { "type": "string" },
+        "descriptions": {
+          "type": "object",
+          "description": "Map of output-format enum value to its one-line description.",
+          "additionalProperties": { "type": "string" },
+          "minProperties": 1
+        },
+        "default": { "type": "string" }
+      }
+    },
+    "voice_input": {
+      "type": "object",
+      "description": "Cross-cutting voice-input block. Emitted when voice input is preferred, before the per-neurotype blocks.",
+      "additionalProperties": true,
+      "required": ["block"],
+      "properties": {
+        "block": { "$ref": "#/$defs/block" }
+      }
+    },
+    "tourette": {
+      "type": "object",
+      "description": "Tourette special block. Tool-independent; rendered whenever `tourette` is in the effective set.",
+      "additionalProperties": true,
+      "required": ["block"],
+      "properties": {
+        "block": { "$ref": "#/$defs/block" }
+      }
+    },
+    "other": {
+      "type": "object",
+      "description": "Self-described block. Carries the {notes} interpolation token; rendered when `other` is selected with notes, or appended as a footer when notes are present without `other`.",
+      "additionalProperties": true,
+      "required": ["block"],
+      "properties": {
+        "block": { "$ref": "#/$defs/block" }
+      }
+    },
+    "generic": {
+      "type": "object",
+      "description": "Generic per-neurotype fallback blocks (no tool context, or no concrete per-tool block for the pair). Keyed by neurotype enum value.",
+      "additionalProperties": { "$ref": "#/$defs/block" }
+    },
+    "tools": {
+      "type": "object",
+      "description": "Per-tool matrices of concrete per-neurotype blocks. Keyed by tool name, then by neurotype enum value. Additive: a new tool or a new neurotype within a tool is non-breaking.",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": { "$ref": "#/$defs/block" }
+      }
+    }
+  },
+  "$defs": {
+    "block": {
+      "type": "array",
+      "description": "A prose block: an ordered list of lines joined with the framing block_line_separator. Lines may contain {max_chunk_size} and/or {notes} interpolation tokens.",
+      "items": { "type": "string" },
+      "minItems": 1
+    }
+  }
+}

package/dist/assets/schemas/profile.example.yaml

@@ -62,6 +62,15 @@ preferences:
   #   system_default          — your OS choice
   reading_font_hint: "atkinson_hyperlegible"
 
+  # How much space do you want between lines of text?
+  # This is a hint for apps that show NeuroDock's output as styled text.
+  # Options:
+  #   compact  — lines sit closer together (more text fits on screen)
+  #   default  — the app's own everyday spacing
+  #   relaxed  — extra space between lines; pairs with atkinson_hyperlegible
+  # Leave it out and the app just uses its own spacing.
+  line_height_hint: "relaxed"
+
   # Do you want visual animations turned on?
   # Options:
   #   reduced  — no animations (default; safest for vestibular sensitivity)

package/dist/assets/schemas/profile.schema.json

@@ -90,6 +90,17 @@
           "enum": ["reduced", "system", "full"],
           "default": "reduced",
           "description": "Animation policy hint. 'reduced' = no animation, no transitions, no auto-scroll (default). 'system' = follow the OS prefers-reduced-motion setting. 'full' = animations allowed."
+        },
+        "line_height_hint": {
+          "type": "string",
+          "enum": ["compact", "default", "relaxed"],
+          "description": "Optional (added v0.1.x per ADR 0011). Line-height hint for any client that renders NeuroDock output as HTML or rich text, sitting alongside 'reading_font_hint'. A categorical band rather than a raw multiplier so each client maps it to its own CSS line-height. CONFORMANCE FLOOR: clients MUST NOT render body-paragraph line spacing below 1.5 regardless of band (WCAG 1.4.8 Visual Presentation / 1.4.12 Text Spacing). The bands are advisory line-height ratios relative to font size for body paragraphs; headings and other non-body text MAY be tighter. Per-band anchors: 'compact' ≈ 1.5 — the floor itself, a power-user opt-in for more text per viewport that still respects the 1.5 minimum (for readers who find generous spacing scatters their eye-line and prefer denser text, the dual of why 'relaxed' exists); 'default' ≈ 1.5–1.6 — the client's own comfortable default within the conformant range; 'relaxed' ≈ 1.65–1.8 — generous line spacing (~1.65 is the project body line-height) and the evidence-based pairing with 'atkinson_hyperlegible' for dyslexia, which is why dyslexia-aware presets set it. Read-when-present, neutral-when-absent: an untailored client ignores it; absence is NOT an error. The loader applies no value when absent. Self-ID never gates this (ADR 0004/0011).",
+          "examples": ["relaxed", "default"]
+        },
+        "voice_input_preferred": {
+          "type": "boolean",
+          "description": "Optional (added v0.1.x per ADR 0011). When true, the user predominantly dictates rather than types for sustained work (common for dyspraxic users). Downstream skills that emit code or structured text MUST NOT assume the user can hand-edit fiddly punctuation cheaply: keep examples copy-pasteable as a single block rather than scattered across inline edits. Read by the shaping layer; absence means 'no preference' and is the same as today's behaviour. Consumer pending; schema-only in this release.",
+          "examples": [true]
         }
       }
     },
@@ -121,6 +132,62 @@
           "enum": ["auto_close", "error"],
           "default": "auto_close",
           "description": "Behaviour of mark_session_start when a prior session is still open. 'auto_close' (default, charitable) closes the prior session and returns its metadata so the skill can surface it. 'error' refuses to start a new session until the prior one is explicitly closed. See ADR 0001, open question 3."
+        },
+        "calendar_phase": {
+          "type": "string",
+          "enum": ["teaching", "marking", "exam", "deadlines", "break"],
+          "description": "Optional (added v0.1.x per ADR 0011). Self-declared phase of the user's term/semester so skills can shift defaults across the calendar: tighter break cadence during 'marking' / 'exam', deadline-cluster awareness during 'deadlines' (e.g. week 12), looser during 'break'. Surfaced by the educator-semester and student-university presets. The neurotype is never a branch point (ADR 0004/0011); this is a user input the shaping layer reads, neutral-when-absent. Consumer pending (mcp-chronometric); schema-only in this release.",
+          "examples": ["teaching", "marking"]
+        },
+        "weekday_overrides": {
+          "type": "object",
+          "description": "Optional (added v0.1.x per ADR 0011). Per-weekday overrides for 'end_of_day_local' and 'hyperfocus_break_minutes', covering late-office-hours, Wednesday-afternoon-class, and library-day-vs-lecture-day patterns without forcing a whole-profile swap. Keys are lowercase English weekday names; only the seven weekdays are accepted (a misspelt key is a silent no-op, so unknown keys are rejected here rather than preserved). Each value is an override object reusing the same patterns/ranges as the top-level chronometric fields; an empty override object is valid. A weekday absent from the map inherits the top-level chronometric values. Consumer pending (mcp-chronometric); schema-only in this release.",
+          "additionalProperties": false,
+          "properties": {
+            "monday": { "$ref": "#/$defs/weekdayOverride" },
+            "tuesday": { "$ref": "#/$defs/weekdayOverride" },
+            "wednesday": { "$ref": "#/$defs/weekdayOverride" },
+            "thursday": { "$ref": "#/$defs/weekdayOverride" },
+            "friday": { "$ref": "#/$defs/weekdayOverride" },
+            "saturday": { "$ref": "#/$defs/weekdayOverride" },
+            "sunday": { "$ref": "#/$defs/weekdayOverride" }
+          },
+          "examples": [
+            {
+              "wednesday": { "end_of_day_local": "18:30" },
+              "saturday": { "hyperfocus_break_minutes": 120 }
+            }
+          ]
+        },
+        "protected_windows": {
+          "type": "array",
+          "description": "Optional (added v0.1.x per ADR 0011). Local-time ranges (lunch, post-EOD evening, scheduled lectures, lab times) where the hyperfocus monitor should HARD-SURFACE rather than nudge — the strict rung of the escalation ladder, applied because the window itself is protected, not because a session has run long. Each entry is a 'HH:MM'-'HH:MM' range with an optional human label; ranges are interpreted in the user's local timezone and a range whose 'end' is earlier than its 'start' is treated as wrapping past midnight by the consumer. An empty list is valid. Consumer pending (mcp-chronometric); schema-only in this release.",
+          "items": { "$ref": "#/$defs/protectedWindow" },
+          "examples": [
+            [
+              { "start": "12:00", "end": "12:30", "label": "lunch" },
+              { "start": "17:00", "end": "23:59", "label": "evening" }
+            ]
+          ]
+        },
+        "deadline_cluster_awareness": {
+          "type": "boolean",
+          "description": "Optional (added v0.1.x per ADR 0011). When true, planning skills surface deadline proximity and shift the break-cadence math when work clusters (e.g. three assignments due in a single week). Set by the student-university preset. Read by planning skills; absence means today's behaviour (no clustering adjustment). Consumer pending (task-fractionator); schema-only in this release.",
+          "examples": [true]
+        },
+        "time_buffer_multiplier": {
+          "type": "number",
+          "minimum": 1.0,
+          "maximum": 3.0,
+          "default": 1.0,
+          "description": "Optional (added v0.1.x per ADR 0011). Multiplier that pads presented time estimates because real-world execution time for motor-heavy tasks is systematically underestimated (e.g. 1.3 = +30%, the value the dyspraxia preset sets). Range 1.0..3.0; the neutral default 1.0 reproduces today's unpadded behaviour so an untouched profile is unchanged. Read by planning skills to scale the estimates they present; the underlying estimate is not altered. Consumer pending (task-fractionator); schema-only in this release.",
+          "examples": [1.0, 1.3]
+        },
+        "motor_fatigue_aware": {
+          "type": "boolean",
+          "default": false,
+          "description": "Optional (added v0.1.x per ADR 0011). When true, the hyperfocus monitor weights motor activity (click / keystroke / window-switch volume) into the fatigue signal rather than relying on continuous-session length alone — cognitive sharpness and motor exhaustion can coexist (set by the dyspraxia preset). The neutral default false reproduces today's session-length-only behaviour. Reading motor activity is still gated by 'privacy.os_idle_consent' and the relevant OS-input consents; this flag only declares the preference. Consumer pending (mcp-chronometric); schema-only in this release.",
+          "examples": [true]
         }
       }
     },
@@ -176,6 +243,55 @@
       }
     }
   },
+  "$defs": {
+    "weekdayOverride": {
+      "type": "object",
+      "description": "Per-weekday override for the chronometric fields that vary by day. Both members are optional and reuse the same validation as their top-level counterparts; an empty object means 'this weekday is named but inherits the top-level values'. additionalProperties is false because an unknown key here is almost always a typo that would silently do nothing.",
+      "additionalProperties": false,
+      "properties": {
+        "end_of_day_local": {
+          "type": "string",
+          "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
+          "description": "Override of 'chronometric.end_of_day_local' for this weekday, as 'HH:MM' (24h) in the user's local timezone. Same pattern as the top-level field.",
+          "examples": ["17:00", "18:30"]
+        },
+        "hyperfocus_break_minutes": {
+          "type": "integer",
+          "minimum": 15,
+          "maximum": 240,
+          "description": "Override of 'chronometric.hyperfocus_break_minutes' for this weekday. Same 15..240 range as the top-level field; re-anchors the 'nudge' rung for this day only.",
+          "examples": [60, 120]
+        }
+      }
+    },
+    "protectedWindow": {
+      "type": "object",
+      "description": "A single local-time range where the hyperfocus monitor hard-surfaces. 'start' and 'end' are required 'HH:MM' (24h) strings; 'label' is an optional human-readable name. additionalProperties is false to catch typos in this small, fixed shape.",
+      "additionalProperties": false,
+      "required": ["start", "end"],
+      "properties": {
+        "start": {
+          "type": "string",
+          "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
+          "description": "Window start, 'HH:MM' (24h), local timezone.",
+          "examples": ["12:00", "17:00"]
+        },
+        "end": {
+          "type": "string",
+          "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
+          "description": "Window end, 'HH:MM' (24h), local timezone. An 'end' earlier than 'start' is treated by the consumer as wrapping past midnight.",
+          "examples": ["12:30", "23:59"]
+        },
+        "label": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 80,
+          "description": "Optional human-readable label for the window, surfaced in any notice the monitor emits.",
+          "examples": ["lunch", "evening", "lecture"]
+        }
+      }
+    }
+  },
   "examples": [
     {
       "identity": {