Commit Graph
19 Commits
Author SHA1 Message Date
Nikolay Miroshnichenko fb53018b59 docs(readme): align spec→design headline with the case study (96%, 662 vs 687 GA) in EN+RU — was an inconsistent ~92%/3,600-GA figure vs the 96% badge 2026-08-29 15:30:16 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 8312d531eb feat: check_topology — per-line device count + individual-address validity (KNX canon)
New design-time check grounded in the KNX standard (KNX Handbook + xknx via
deepwiki). detect_topology_issues() + check_topology() MCP tool (30->31 tools),
folded into analyze_all counters:
- devices per line vs TP1 segment 64 / line 256 (KNX Handbook p.36/40/55) — TP-only
- individual address valid A.L.D (area 0-15, line 0-15, device 0-255; xknx-confirmed)
- duplicate individual address -> error; missing .0 coupler on a multi-line TP -> info
Medium-gated on the real xknxproject string ('Twisted Pair (TP)'), so IP/PL/RF
lines are never falsely flagged (fixed a dead 'medium==IP' guard caught in audit;
regression test added). senior-code-audit: APPROVED. Functional smoke on 2 real
projects: IP lines clean, TP coupler/count notes correct. 64/256 cited to the
Handbook, not attributed to xknx. tests/test_topology.py 7/7; suite 27 passed
(pre-existing unrelated test_protocol collection error untouched).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-24 21:41:14 +02:00
Nikolay1andClaude Opus 4.8 f0d1afdce2 docs(readme.ru): bring RU tool table to parity with EN (25 → 30)
Add the 5 tools missing from the RU table (present in EN + server.py):
- explain_ga            → Чтение
- check_policy          → Валидация
- check_device_parameters → Починка и дизайн
- validate_room_template, compose_rooms → new Room Library group
Descriptions mirror EN meaning, signatures verified against server.py.
Bump counters: '## 5. Инструменты MCP (25)' → (30) and package layout
'25 инструментов' → 30. RU table now 30 rows, 1:1 with EN.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-15 22:09:22 +02:00
Nikolay1andClaude Opus 4.8 ce64250eac docs(readme): align narrative with product (Room Library R1 + shipped roadmap)
Positioning-only sync (tool table untouched):
- Intro: 'Three things' → 'Four things' + new bullet 'Compose a new project
  from parametrised room templates' (dry-run, new projects only, R1).
- Add Scenario 4 (compose_rooms → allocation manifest + ETS XML/CSV + device
  BOM; generated .knxproj re-read by standard loader, 0 errors / 0 warnings;
  R2 docking + device selection flagged as planned).
- Roadmap: reframe check_device_parameters and check_policy as shipped (they
  are already in the tool table); add Room Library R1 shipped / R2 planned;
  keep ETS7 Smart Linking note.
- Package layout: add room_library.py + room_templates/.
- README.ru.md: mirror the intro, Scenario 4 and package-layout edits (ru has
  no Roadmap section). NOTE: ru tool table still lags at 25 vs EN 30.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-15 22:04:53 +02:00
Nikolay Miroshnichenko 54413ce2bd docs(readme): reflect skills/ package in the 4-layer table and package layout (EN+RU) 2026-07-07 22:24:34 +02:00
Nikolay MiroshnichenkoandClaude Fable 5 1aea8a6d9b feat(skills): ship ha-git-backup — two-circuit HA backup ops-companion skill
Circuit 1: real git in /config (deploy key, pre-commit secret scanner,
meaningful commits). Circuit 2: age-encrypted native HA backups in GitHub
Releases with rotation and a mandatory monthly restore drill. Ships
install/sync/scan/offsite/restore scripts, HA automations/snippets,
setup + architecture + incident + runbook references, EN + RU skill docs.
README/README.ru gain an ops-companion bullet in Scenario 3;
CHANGELOG [Unreleased] Added entry (no version bump).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-07 22:15:44 +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 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 6327fed487 docs(readme.ru): sync Russian README to v0.6.0 (24 tools + repair/device-library/handover/diff capabilities)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-01 20:57:37 +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 bba0b33614 docs(readme): document colour/climate assembly + GA-intent noise reduction
Root README + RU now list the Track A/D capabilities: GA-intent classification
(reserve/logic/scratch kept out of error & missing-status checks), colour light
assembly (RGBW/RGB/CCT) and climate entity generation, with the real 685-GA
Zennio validation figure (false errors 29 -> 6).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-30 20:46:02 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8 9a8d87869a docs: add Glama score badge (server now built & released on Glama)
Glama Docker introspection passes (build success, MCP release created).
Satisfies awesome-mcp-servers listing requirement: server is on Glama
and the score badge is now shown in both READMEs.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-29 07:53:43 +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 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 bba8befcde nickol-knx-mcp v0.1.0 — design-time KNX/ETS6 MCP server (public beta)
Design-time MCP server that reads .knxproj (read-only), validates naming/DPT/status,
and generates Home Assistant KNX YAML + ETS-importable group addresses (XML/CSV).
No live bus access — confined-workspace writes only.

Includes: 12 MCP tools, end-to-end smoke test, MIT license, English-first README
(+ Russian), CONTRIBUTING with a real-project test call, SECURITY policy, CHANGELOG,
GitHub Actions CI (Python 3.10–3.12), and issue/PR templates.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-28 09:25:57 +02:00