Skip to content

Releases

v1.4.1

Choose a tag to compare

@github-actions github-actions released this 31 Oct 23:28

Full Changelog: v1.4.0...v1.4.1

v1.4.0

Choose a tag to compare

@github-actions github-actions released this 31 Oct 19:46

Full Changelog: v1.3.0...v1.4.0

v1.3.0

Choose a tag to compare

@github-actions github-actions released this 31 Oct 19:37

Full Changelog: v1.2.7...v1.3.0

v1.2.7

Choose a tag to compare

@github-actions github-actions released this 31 Oct 19:17

Full Changelog: v1.2.6...v1.2.7

naqsha 1.2.6 — install straight from npm

Choose a tag to compare

@horizonbymuneeb horizonbymuneeb released this 28 Oct 08:43

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-skill command: runs the installer that ships inside the npm package, validates the agent name, supports --prefix DIR, --no-verify and --list, and reports a clear error when bash is missing (Windows).
  • README, docs/INSTALL.md and docs/USAGE.md now lead with the npm route; git clone && ./install.sh stays 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

Choose a tag to compare

@horizonbymuneeb horizonbymuneeb released this 28 Oct 08:37

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

Choose a tag to compare

@horizonbymuneeb horizonbymuneeb released this 28 Oct 08:30

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 version print the installed version; --help lists every command with runnable examples.

Mermaid

  • Native erDiagram output for ERD (entities, PK/FK/UK marks, 1:1 / 1:n / n:m relations) and classDiagram for class (members, <<interface>>/<<abstract>>, inheritance/composition/dependency markers).
  • naqsha convert ingests both dialects back into valid IR; round-trip verified on the ERD and class examples (only ERD attribute ref is 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

Choose a tag to compare

@horizonbymuneeb horizonbymuneeb released this 28 Oct 07:59

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.md metadata refreshed: version follows the release, description lists all ten diagram types.

npm

  • npm i -g naqsha-cli installs the naqsha binary; the tarball also ships install.sh, SKILL.md and 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

Choose a tag to compare

@horizonbymuneeb horizonbymuneeb released this 28 Oct 07:26

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.