Repository navigation
Releases
v1.4.1
Full Changelog: v1.4.0...v1.4.1
v1.4.0
Full Changelog: v1.3.0...v1.4.0
v1.3.0
v1.2.7
naqsha 1.2.6 — install straight from npm
No clone needed any more.
npm i -g naqsha-cli
naqsha install-skill --agent all # or --agent claude / dsh / codex / ...
naqsha install-skill --list # agent → skills-root map- New
naqsha install-skillcommand: runs the installer that ships inside the npm package, validates the agent name, supports--prefix DIR,--no-verifyand--list, and reports a clear error when bash is missing (Windows). - README,
docs/INSTALL.mdanddocs/USAGE.mdnow lead with the npm route;git clone && ./install.shstays as the contributor/offline alternative. - Tests cover the map, a real install into a throwaway prefix, and the exit codes.
Verified: 163 unit tests, 165 acceptance checks, 47–55 interaction checks per artifact.
naqsha 1.2.5 — verification counts
Documentation-only release: the README now states the counts measured on the 1.2.4 tree — 160 unit tests, 165 acceptance checks, 47–55 live-HTML interaction checks per artifact — and the release notes and changelog match. No code, example or artifact changed.
Verified after the fix: 160/160 unit tests.
naqsha 1.2.4 — usage guide, native Mermaid, self-demo
Use it: new docs/USAGE.md — quick start, nine agent prompt recipes, the validate → repair → render loop, CLI recipes with receipts, the ten-type picker, six IR rules with error codes, the artifact keyboard table and troubleshooting.
CLI
naqsha --version/naqsha versionprint the installed version;--helplists every command with runnable examples.
Mermaid
- Native
erDiagramoutput for ERD (entities, PK/FK/UK marks, 1:1 / 1:n / n:m relations) andclassDiagramfor class (members,<<interface>>/<<abstract>>, inheritance/composition/dependency markers). naqsha convertingests both dialects back into valid IR; round-trip verified on the ERD and class examples (only ERD attributerefis dropped, with a warning — Mermaid has no syntax for it).- The other five types keep the flowchart fallback with an explicit warning.
Self-demo
examples/naqsha-repo.architecture.json+docs/demo-naqsha-repo.html: this project mapping its own pipeline — skill contract, CLI, validator, layout, viewer, artifact, test harnesses, distribution — with a 4-step walkthrough.
Verified: 160 unit tests, 165 acceptance checks (real Chrome, 1440×980 and 390×844), 53 interaction checks on the new artifact, exporter output validated against a real Mermaid 11 renderer.
naqsha 1.2.3 — per-agent install guide
Installation is now documented per agent, and the npm package is live.
Docs
- README: agent → skills-root → command table for DeepSeek Harness, Claude Code, Codex, Hermes, opencode, Cursor and Gemini CLI, plus the npm route without cloning.
- New
docs/INSTALL.md: quick start, one-agent-at-a-time installs, custom prefixes for CI, upgrade, uninstall, Windows/WSL note, Chrome hint and troubleshooting. SKILL.mdmetadata refreshed: version follows the release, description lists all ten diagram types.
npm
npm i -g naqsha-cliinstalls thenaqshabinary; the tarball also shipsinstall.sh,SKILL.mdand the examples, so the skill can be registered into any agent without cloning.
Verified
- Fresh installs into isolated prefixes for DSH, Claude Code and Codex, and a global npm install followed by the shipped installer: every path ends in the installer's own validate + render check and a working
naqsha types/naqsha validate. - 141 unit tests, 152 acceptance checks, 47–55 interaction checks per artifact.
naqsha 1.2.2 — free diagram skill for coding agents
A free diagram skill for coding agents: ten diagram types from one small JSON file to one self-contained interactive HTML page.
Includes
- Ten types — architecture, workflow, sequence, erd, class, tree, timeline, waterfall, dataflow, lifecycle — each with its own layout.
- Interactive artifact — guided walkthroughs, diff styling, minimap,
/search, share state, inspector, in-page route tracing, presentation laser, export (SVG, PNG 2×, WebP, JPEG, Mermaid, JSON), print, light/dark, a11y, mobile pinch-zoom. - CLI — validate, render, diff, path, convert, mermaid, fix, demo, doctor, screenshot, types.
- Zero runtime dependencies; Node ≥18; MIT.