SpecBook 1.5.2

1.5.2 (2026-10-10)

• IMPROVEMENT [spec]: Grouping of Non-Functional Requirements
  The Non-Functional Requirements artifact gets a GROUP kind (a quality goal spanning the
  categories, drawn as a box around its requirements) and the requirements a GROUP property.

SpecBook 1.5.1

release version 1.5.1

SpecBook 1.5.0

1.5.0 (2026-10-10)

• IMPROVEMENT [spec]: Architecture Tenets Artifact in the Standard Schema
  The new ARCH artifact Architecture Tenets (AT) holds the architecture maxims and principles
  the decisions, tactics, and aspects reference via GUIDED-BY; the artifacts after it renumber.

• IMPROVEMENT [spec]: Architecture Patterns Artifact in the Standard Schema
  The new ARCH artifact Architecture Patterns (AP) holds the reusable structural patterns the
  components, tactics, decisions, and code patterns reference; the artifacts after it renumber.

• IMPROVEMENT [spec]: Compact Tables for the Requirements
  The requirements of the Functional Requirements and Non-Functional Requirements artifacts now
  render as compact tables, as their many properties no longer fit a concise table row.

• IMPROVEMENT [spec]: Grouping and Dependencies of Functional Requirements
  The Functional Requirements artifact gets a GROUP kind (an epic or feature, drawn as a box
  around its requirements) and the requirements a GROUP and an acyclic DEPENDS-ON property.

• IMPROVEMENT [code]: Lay Out D2 Diagrams With TALA By Default
  The embedded D2 diagrams are now laid out by the TALA engine of @d2lang/d2 by default,
  while a diagram's own d2-config layout-engine still wins.

• UPDATE [infr]: Upgrade NPM Dependencies
  The NPM dependencies were updated.

SpecBook 1.4.2

release version 1.4.2

SpecBook 1.4.1

1.4.1 (2026-10-08)

• IMPROVEMENT [code]: Create Project Configuration on Initialization
  specbook init now persists the effective config and basedir into a new .specbook.yaml
  in the working directory, unless one already applies.

• IMPROVEMENT [code]: Seed Title Properties on Initialization
  specbook init now seeds the META: Title artifact with the properties the exports interpret
  (LOGO, TITLE, ..., PAPER-SIZE), each with its rendering default, as far as configured.

• IMPROVEMENT [spec]: Optional Artifact Contents in the Standard Schema
  The properties and child object kinds of all artifacts are now optional, so a freshly
  initialized specification (specbook init) already lints cleanly instead of failing.

• IMPROVEMENT [code]: Diagram Center Label Falls Back on Absent Property
  A synthetic diagram center whose source lacks the property now takes its label or the
  name of the source object, instead of failing the diagram.

• UPDATE [infr]: Upgrade NPM Dependencies
  The NPM dependencies were updated.

SpecBook 1.4.0

1.4.0 (2026-10-04)

• IMPROVEMENT [code]: Lined Instead of Striped Property Tables
  The property tables drop their row stripes for a tinted key column, a transparent value column,
  and thin grey row lines, and attach seamlessly to the cell borders inside compact tables.

• IMPROVEMENT [code]: Fixed-Width Name Column of the Object Tables
  The name column of the concise/compact tables and the key column of the property tables take
  a fixed 20%, so all tables align, while the property columns share the remaining 80%.

• IMPROVEMENT [code]: Sub-Headers in the Compact Object Format
  The content cell of a compact table leads its diagram, properties, and description with the
  sub-headers "Diagram", "Properties", and "Description", styled like the chunk headers.

• FEATURE [code]: Compact Object Format
  The new format type compact renders a table whose single content cell holds the hub diagram,
  properties, and description; used for COMPONENT, PREMISE, TERM, and PERMISSION.

• FEATURE [spec]: Code Patterns Artifact in the Standard Schema
  The new ARCH: Code Patterns artifact (after Design Decisions) records CODE-PATTERN objects
  showing as a listing how a recurring concern is coded (APPLIES-TO, REALIZES, DECIDED-BY).

• REFACTORING [spec]: Dialog Pattern Kind Renamed to DIALOG-PATTERN
  The PATTERN kind of UXUI: Dialog Patterns is now DIALOG-PATTERN (headings and [[...]]
  references alike), which frees the name for the code patterns and reads unambiguously.

• FEATURE [code]: Syntax-Highlighted Code Listings
  Fenced code blocks and embedded source files (#lines=, #mark=) render via Shiki with line
  numbers and themed keywords/literals/comments in DejaVu Sans Mono, and fold, maximize, omit.

• FEATURE [code]: Embedded Mermaid and D2 Diagrams
  Fenced mermaid/mmd/d2 blocks and embedded .mmd/.mermaid/.d2 files are rendered
  as themed diagrams, which fold, maximize, and omit (-O diagram:code) like Gradia ones.

• FEATURE [code]: Embedded PDF Pages
  Embedded .pdf files (#page=<n> selecting the page) are converted to vector SVG with lazily
  loaded pdfjs-dist/@napi-rs/canvas and then treated exactly like embedded SVG images.

• IMPROVEMENT [code]: Embedded Images Fold and Maximize
  Embedded SVG/PNG/JPEG/WebP images (except the title page logo) fold, maximize, and omit
  (-O diagram:image) in the HTML/PDF export exactly like the embedded diagrams.

• FEATURE [code]: Dark Theme Treatment of Embeddings
  The dark fragment parameter of images and PDF pages selects invert, none, or auto
  (the default, detecting light pages with dark ink) as their treatment on the dark theme.

• BUGFIX [code]: Rationale Ends with Its Paragraph
  The blocks following a , BECAUSE paragraph ended up inside the rationale and lost their
  embeddings and diagrams, and now form the new description elaboration instead.

• BUGFIX [code]: Self-Adapting SVG Images Follow the Document Theme
  An SVG image with light-dark() colors followed the system color scheme instead of the
  document theme, as the HTML export now sets color-scheme on every image on screen.

SpecBook 1.3.2

1.3.2 (2026-09-29)

• UPDATE [infr]: Upgrade NPM Dependencies
  The NPM dependencies were updated.

SpecBook 1.3.1

1.3.1 (2026-09-22)

• BUGFIX [code]: Git Exclude Rules Matched Exactly like Git
  A trailing /** no longer excludes the directory itself, [!...] classes, core.ignoreCase,
  and leading/escaped trailing whitespace are honored, and core.excludesFile is expanded by Git.

• BUGFIX [code]: References Inside Diagrams and Automata Resolved Completely
  The diagram derivation matched [[...]] on the raw instead of the plain property text, and the
  automaton checks took only the first reference of an edge, so edges and transitions got lost.

• BUGFIX [code]: Artifact and Configuration Inputs Handled Robustly
  A UTF-8 byte order mark no longer hides the frontmatter, C:\... artifact paths are rejected,
  -c std embeds the standard configuration, and inaccessible directories count as absent.

• BUGFIX [code]: Title Object Properties Rendered Consistently
  An empty SUBTITLE/AUTHOR/VERSION/LOGO counts as absent (the fallback logo included), and
  an absent TITLE falls back onto "Specification" instead of the name of the title object.

• BUGFIX [code]: PDF Decoration Accent and Browser Resolution
  The dark accent of the brand bar and headers used spread index 24 instead of the 22 of the
  HTML, and a failed browser lookup was memoized for the process lifetime of the MCP service.

• BUGFIX [code]: Client-Side Scripts of the HTML Export
  The popup title regex lost its \s, a stale search outlived a live preview body swap, the fold
  chevron of a search-hidden diagram floated, and the theme switch clobbered maximized.

• BUGFIX [code]: -O text:long Aligned with the Client-Side Cell Folding
  A cell is cut only when it exceeds the maxCellHeight excess (both sides sharing one pair of
  threshold constants), and a cut behind a task list checkbox no longer emits </input>.

• BUGFIX [code]: Watch Mode and Preview Robustness
  An edit during the initial export is no longer lost, a failing observe start releases the bound
  port, and usage errors are reported before the browser is probed or the port is bound.

• IMPROVEMENT [code]: Clearer Diagnostics for Themes, Nested Blocks, and Image Optimizations
  Invalid THEME-TONE/THEME-STYLE values fail up-front naming the property, block content
  nested into list items yields nested <type> ... ignored, and a failed Sharp/SVGO run a notice.

• IMPROVEMENT [code]: Consistent Option Parsing across --verbose, --compress, and --port
--compress accepts the boolean words of --verbose (SPECBOOK_COMPRESS=yes), and --port
  rejects hexadecimal, exponent, and padded forms like the other numeric options.

• IMPROVEMENT [code]: Search Filters the Table of Contents in a Single Layout Pass
  The visibility reads and the hiding writes of the entries are batched instead of interleaved,
  which forced a synchronous re-layout per heading on every search run.

• REFACTOR [code]: Internal Structure of the Diagram Derivation, Renderers, and API Types
  The derivation context travels as one DiagramContext, over-long functions are split below
  the 100-line mark, and ExportRequest/WatchRequest name the API option shapes.

• CLEANUP [code]: Stylus Mixins, Type-Safe Choice Parsing, and Minor Consistency Fixes
  The brand bar tabs and circle icons share tab()/icon() mixins, the choice parsers narrow
  via find, and misleading names, redundant checks, and the formatting are corrected throughout.

SpecBook 1.3.0

1.3.0 (2026-09-20)

• BUGFIX [infr]: fix version

SpecBook 1.2.16

release version 1.2.16