Commit Graph
21 Commits
Author SHA1 Message Date
Nikolay Miroshnichenko 4eb54da53c tools: local corpus guard against real ETS projects
Public CI only runs synthetic fixtures, but every regression we have actually
shipped showed up on real projects, which are confidential and cannot reach a
GitHub runner. corpus_check.py runs a local corpus through the full pipeline
(parse, checks, HA YAML, entity suggestions) and diffs the counts against a
recorded baseline.

Only numbers are committed: counts, severity and code histograms, and a short
digest per source file. The project map with real paths lives in
tools/corpus_map.json, which is gitignored; corpus_map.example.json shows the
shape. Verified both directions: a deliberate change to the diagnostics filter
made the guard exit 1 and name the two metrics that moved, a clean tree exits 0,
and a machine without a map exits 2 without doing anything.

Wired into CONTRIBUTING and into the release checklist before the build step.
2026-09-12 21:31:44 +02:00
Nikolay Miroshnichenko 80fc279ac1 docs: release checklist (PyPI + official MCP Registry), with the traps hit during 0.8.1 2026-09-12 09:02:08 +02:00
Nikolay1andClaude Opus 4.8 3d0aa8ec29 docs(site): sync landing to 30 tools + add Room Library scenario
Tool count 25 → 30 (meta description + tools card). Add a 4th scenario
card 'Compose a new project' (compose_rooms → allocation manifest + ETS
XML/CSV + device BOM; dry-run, new projects only, R1). Clarify the
read-only thesis: never mutates your source .knxproj or touches the bus.
Update 'three'→'four scenarios' heading + anchor. R2 (docking + device
selection) flagged as planned.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-15 21:55:00 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 bc1e4079f5 docs(site): mention ha-git-backup ops companion in scenario 3 — content parity with README
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-07 22:44:18 +02:00
Nikolay Miroshnichenko 5dbdf536c2 docs(announcements): current header → v0.8.0 2026-07-07 12:27:18 +02:00
Nikolay Miroshnichenko 8bbdb6c600 docs: sync surfaces to v0.8.0 — positional pairing + ref-level parsing wording (EN/RU), site pill 2026-07-07 12:26:44 +02:00
Nikolay Miroshnichenko c622303cc6 docs(site): add a dedicated three-scenarios section (design-from-spec / audit-repair / HA layer + device-library foundation) 2026-07-02 10:10:40 +02:00
Nikolay MiroshnichenkoandClaude Fable 5 e98ab0c7ef docs: restructure README/site around the three usage scenarios
Reframe README.md, README.ru.md and docs/index.html around what you can
do with the server: (1) design a project from a spec into a full
implementation kit, (2) audit/repair/finish an existing .knxproj,
(3) generate the Home Assistant layer — plus the device-library
foundation. Adds anonymised field numbers from real project validation
(~92% structural match on 3,600+ GA; 145 repair proposals on 3,646 GA).
No functional changes, tool count unchanged (25), not a release.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 09:57:07 +02:00
Nikolay MiroshnichenkoandClaude Fable 5 5651be2930 feat: exact device models — local catalog for decompose_device + parse_devices_from_project (v0.7.0)
- device_library: NICKOL_KNX_CATALOG env points at a local device-library
  YAML file/dir; decompose_device returns the exact vendor object model
  (source: catalog-exact) and falls back to generic recipes
  (source: recipe-approximate). Env unset = behaviour unchanged.
- appprog_parser (new) + MCP tool parse_devices_from_project: deterministic
  extraction of exact comm-object models from M-* application programs in a
  .knxproj/.knxprod (order number via nested <Product>, DPST-x-y -> x.00y,
  per-channel block/stride detection, coverage manifest). Read-only,
  PII-safe: never reads the client P-*/0.xml. Now 25 MCP tools.
- tests: test_device_catalog.py + test_appprog_parser.py (synthetic,
  self-contained)
- docs: README/README.ru/docs site/announcements synced to v0.7.0, 25 tools

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 06:48:19 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 224f44a9c5 docs: sync release surfaces to v0.6.0 (C4 consistency)
- CHANGELOG: fix stale compare-link footer (Unreleased→v0.6.0, add
  0.4.0/0.5.0/0.6.0 links)
- docs/index.html: bump hero version pill v0.2.0 → v0.6.0
- docs/announcements: update 'Current:' marker to v0.6.0 / 24 tools

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-01 21:17:40 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 4893d18bc0 docs(site): update landing to v0.6.0 — 24 tools, repair/device-library/handover/diff/matter capabilities
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-01 21:07:50 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 d7df3dce60 feat: device-library decompose_device + spec→structure methodology (v0.3.0)
Turn the tool from a .knxproj validator into a design aid.

- device_library.py + decompose_device / list_device_recipes MCP tools:
  expand a device (order number / type / alias) into its group-address
  recipe — command/status/dimming/position/mode objects with DPTs —
  across Zennio + ABB families. Generic vendor facts, typical-wired set.
- docs/spec-to-structure.md: the spec→structure methodology, with a
  measured account of what a spec reproduces (~90%) vs the per-device
  object count it cannot (2–9× per-project parameterisation).
- Ship alongside the Track B generate_handover_pack and the de-noise
  refinements accumulated since 0.2.0.
- CHANGELOG 0.3.0; version bump 0.2.0 → 0.3.0; new device-library tests.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-01 18:33:08 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 bc33273cd4 docs(announcements): refresh KNX forum / HA / Reddit posts for v0.2.0 + case study
Lead with colour/climate assembly, noise reduction, and the spec-PDF→96%
case study. Added a dedicated r/knx variant. EN+RU. Posts remain the owner's
to publish from their own accounts.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-01 00:00:18 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 2d0a63c548 docs: add spec-PDF→KNX case study (EN+RU, anonymised)
A 96% structural match of an auto-designed GA structure vs a professional
reference, from a 42-page spec alone — 662 GA, 0 validation errors, HA package.
No client data/files; reference used only as an anonymous benchmark.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-30 23:27:32 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 b9440cb4d7 docs: architecture table + site pill reflect colour/climate + GA-intent (v0.2.0)
Layer-2 (design-time) row in both READMEs now lists colour/climate assembly and
GA-intent de-noise; site version pill bumped to v0.2.0 to match the release.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-30 21:31:09 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 4f8ffb76ba docs(web): refresh demo-house screenshots + captions for colour & climate
Re-captured all 5 live HA dashboard views (consistent 1240px, no PII): overview
now shows the floor-heating climate snapshot, climate shows the 6 floor-heating
thermostats + valve gauges, lighting shows RGBW/RGB/CCT colour lights (the prior
'Ошибка' was a non-existent light-color tile feature, now removed). Site fact
cards + gallery captions + both READMEs updated to describe colour/climate.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-30 21:17:30 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 7b103673c9 Add 'Join the discussion' links (README EN/RU + site)
Discussions badge + call-to-action linking to Discussion #1, plus a nav 'Discuss'
link and a CTA button on the landing site.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-28 21:22:26 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 9f670f0dc9 Add launch announcement drafts (EN+RU) per platform
Ready-to-post messages for GitHub Discussions, KNX User Forum, Home Assistant
forum, Reddit, Discord, Telegram (RU) and an awesome-mcp-servers catalog entry.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-28 21:06:38 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 4798dbdc90 Add real Home Assistant screenshots: site gallery + README
Five real screenshots of the live Demo House dashboard (overview/climate/lighting/
energy/presence). The site now leads with a real screenshot gallery (interactive
mock kept below), and both READMEs gain a live-dashboard gallery section.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-28 20:08:23 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 6b646df1fe README: announce the live demo with a banner + link
Add a linked SVG hero banner (docs/assets/banner.svg), a 'live demo' badge, a
heading link and a callout pointing to the GitHub Pages site and the demo house,
in both README.md and README.ru.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-28 19:58:47 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 eb50a8247f Add docs/ GitHub Pages landing site
Self-contained HTML showcase: hero, two-layer architecture, demo-house stats +
the 5 planted mistakes, an interactive 5-tab dashboard preview (Overview/Climate/
Lighting/Energy/Presence), the HA brain, and a testers CTA. .nojekyll included.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-28 19:46:40 +02:00