kessetsu
Skip to content

Changelog

On this page

All notable changes are documented here. Kessetsu follows Semantic Versioning for product releases and versions its machine contracts independently.

[Unreleased]

[1.6.0] - 2026-11-15

Release 1.6.0 adds interactive schematic ΔV/I/P probing and -10%/+10% quick-tweak with auto-rerun, zero-click auto-simulate on load, a redesigned /install/ MCP vs CLI onboarding experience, clickable kess share / kessetsu_share_link URLs, non-inverting-opamp and zener-regulator calculators, differential V(A, B) probes, freq/period/duty_cycle/thd/initial/flexible pwl support, 13 built-in semiconductor and op-amp models, diode pin aliases, and unified multi-step WorkflowDialog wizards.

Web Hub UX and workflow wizards

  • Unified multi-step WorkflowDialog wizards:
    • Standardize all Web Hub Analyze tools on page-like multi-step WorkflowDialog wizards with distinct step navigation, validation states, and sticky action footers:
      • Parameter study (Analyze → Parameter study…): 5-step guided flow (Method → Variables → Checks → Review & Run → Results), explicit snapshot tracking when the editor circuit changes, and explicit opt-in run comparison against previous results.
      • Compare data (Analyze → Compare data…): 4-step guided flow (Observed → Reference → Match → Results) with collapsible advanced panels for CSV dialect, calibration gain/offset, missing-value behavior, and provenance metadata.
      • Work with an AI agent (Analyze → Work with an AI agent…): 3-step guided flow (Task → Proposal → Review) where Copy agent task and Download task file automatically advance to Proposal, Paste from clipboard & check and Upload reply file… verify and advance to Review, and simulation verification (Run simulation) and applying changes (Apply to editor) remain explicit review actions.
  • Automated bundled model binding and local model management:
    • Automatically bind bundled .lib reference models in memory when selecting built-in external-device examples (External Comparator, Threshold Memristor) from File → Examples, enabling immediate out-of-the-box compilation and simulation.
    • Streamline local external subcircuit model management and file binding in View → Circuit details… and the inline Choose model files… action.
  • Zero-click auto-simulate on load and /install/ MCP vs CLI redesign:
    • Automatically run simulation when the Web Hub opens with an analyzable circuit, switches examples, imports a SPICE netlist, or opens a shared URL (unless required external local model files are not yet attached).
    • Redesign /install/ with dedicated MCP (AI Agents) and CLI (Terminal & CI) onboarding tabs and client-specific configuration guides.
  • Workspace layout and responsive polish:
    • Replace simulation onboarding placeholder steps with a direct one-click simulation empty state.
    • Introduce viewport-aware overflow scrolling for the File → Examples submenu to prevent clipping on constrained displays.
    • Remove unnecessary hero console scrollbars and improve responsive layout behavior.
    • Streamline the Calculators utility UI with a compact, focused form and results layout.

Architectural maintainability and code structure

  • Web Hub Analyze modular decomposition:
    • Decompose large Web Hub dialog components into focused submodules: ResearchDataParts for CSV preview, column mapping, and residuals; StudySteps for parameter axes, tolerance configs, and candidate grids; and AgentProposalParts for task packaging, proposal verification, and diagnostic recovery.
  • Core and CLI module organization:
    • Modularize the SPICE netlist import subsystem into dedicated spice_import submodules for tokenization, card parsing, expression evaluation, and device folding.
    • Decompose the native kess CLI into focused command support modules across test, simulation, study, data, and export pipelines.
  • Schematic symbol reveal:
    • Extend schematic-to-source symbol reveal and canvas selection highlighting for jfet, couple, and device components.
  • Measurement and schematic rendering polish:
    • Add pk2pk (with aliases p2p and vpp) as a reduction metric (max - min over transient or DC-sweep series data, supporting optional [start, stop] transient windows).
    • Position negative-rail supply labels on top pins and positive-rail supply labels on bottom pins outside the vertical lead stub so label text never overlaps the supply lead wire.

Language, measurements, built-in models, and calculators

  • Everyday LEDs, P-channel power VDMOS, asymmetric op-amp macromodels, and diode pin aliases:
    • Add built-in indicator LED diode models (LED_RED, LED_GREEN, LED_BLUE, LED_WHITE), P-channel power VDMOS IRF9540, and asymmetric/symmetric rail-headroom op-amp macromodels LM358 (vdrop_high=1.5V, vdrop_low=20mV, GBW=1MHz, SR=0.5V/us, rout=50Ohm) and TL072 (vdrop_high=1.5V, vdrop_low=1.5V, GBW=3MHz, SR=13V/us, rout=50Ohm) across Core and SPICE import (X... LM358|TL072 and inline .model ... VDMOS with pchan/nchan).
    • Support case-insensitive diode pin aliases anode / a (-> p1) and cathode / k (-> p2) in connect statements, part pin_map strings, and V(D1.anode, D1.cathode) / V(D1.a, D1.k) measurements across all analyses.
    • Enrich KES-C003 unknown-model diagnostics with available built-in model names and typed model / external_subcircuit syntax hints.
  • Measurement completeness across OP, DC Sweep, Pulse sources, and Switches:
    • Support dissipation(dev) on Operating Point (Dataset::OperatingPoint) analyses when no transient dataset is present.
    • Guard Dataset::DcSweep current evaluation so capacitors (I(C1)) return steady-state zero current rather than differentiating against the swept voltage/current axis, and current_source uses its steady-state DC level.
    • Implement Waveform::Pulse current evaluation and I(Switch) / P(Switch) branch current and power evaluation across analyses.
  • CLI & MCP share links (kess share, kessetsu_share_link) and --measure simulation queries:
    • Add core/src/share.rs (kessetsu.share.v1 / kessetsu.share_link.v1), kess share CLI command, kessetsu_share_link MCP tool, share_url in kess tool / kessetsu_tool calculator outputs, and Copy share link on Web Hub /tools/.
    • Add repeatable --measure <EXPR> on kess simulate and measure: string[] on kessetsu_simulate, plus automatic V(<net>) and I(<comp>) operating-point summary population when measurements would otherwise be empty.
    • Return the full kessetsu.spice-import.v1 report from kessetsu_import_spice, and automatically strip inline assert lines in kessetsu_test when external requirements or requirements_path is provided.
  • Interactive schematic inspector, quick-tweak, derived plot traces, and Monaco completions:
    • Upgrade the Web Hub .schematic-navigator (SchematicPanel.tsx) with live simulated ΔV, I, and P readouts, 1-click Plot V / Plot I / Plot P and + Compare waveform overlays, wire segment click hit-testing, and inline -10% / +10% component value quick-tweak with automatic simulation rerun.
    • Synthesize derived I(...), P(...), and differential V(A, B) plot traces in plot.ts and ResultsPanel.tsx, preserve selected dataset tabs and trace overlays across reruns, expand context-aware Monaco completions and hover docs, and accept markdown-fenced or raw .kess source in Work with an AI agent… proposal paste.
  • Differential net voltages and periodic/harmonic assertions:
    • Support differential net voltage V(NET_A, NET_B) (including ground and mixed component.pin/net endpoints) across OP, Transient, DC Sweep, and AC frequency-domain metrics (gain, gain_at, lower_cutoff, upper_cutoff, bandwidth/cutoff, phase).
    • Add freq (alias of frequency, 1 or 3 args), period (1 or 3 args), and duty_cycle / duty (1 or 3 args) periodic transient metrics, and extend thd to accept 2-argument (thd(signal, fundamental)), 4-argument (thd(signal, fundamental, start, stop)), and 5-argument (thd(signal, fundamental, start, stop, hann)) forms.
  • Node initial conditions (initial) and flexible pwl syntax:
    • Add initial V(NET) = <voltage> (literal or {expr}, including module-local nets) with ERC validation, SPICE .ic V(<net>)=<voltage> generation before .control, LTspice !.ic export, and round-trip SPICE .ic import.
    • Accept comma- or space-separated pwl(0s 0V, 1ms 5V) / pwl(0s 0V 1ms 5V) source waveform pairs (including {expr} expressions) and implement linear time interpolation for current_source PWL waveforms.
  • Six classic built-in semiconductor models and JFET current saving:
    • Add built-in 1N5819 (Schottky diode), BC547 (NPN BJT), BC557 (PNP BJT), 2N7000 (NMOS), BSS84 (PMOS), and J201 (NJF JFET) models across Core and SPICE import collision handling, plus native Ngspice @J_<id>[id] drain current saving.
  • Engineering calculators and Monaco editor support:
    • Add non_inverting_opamp (/tools/non-inverting-opamp/) and zener_regulator (/tools/zener-regulator/) calculators alongside divider and rc-lowpass across Core, kess tool CLI, kessetsu_tool MCP, and Web Hub /tools/.
    • Add Monaco syntax highlighting and completions for initial, freq, period, duty_cycle, and duty.

[1.5.0] — 2026-11-01

Expanded SPICE and semiconductor device coverage (vcvs, vccs, ccvs, cccs, switch, Zener breakdown diodes, jfet, couple magnetic coupling, 4-terminal MOSFET bulk pin b, exp transient waveform, biased ac sources, .param math expressions, and RKM notation), physical op-amp macromodeling (KESSETSU_OPAMP_V2), deterministic parameter studies (kess study) and engineering calculators (kess tool), canonical 1.5 showcase circuits, and a progressive-disclosure public website and onboarding experience.

SPICE and device domain expansion

  • Linear SPICE dependent sources:
    • Add native linear SPICE dependent sources to Circuit IR, parser, SPICE netlist generation, Schematic IR, and Web Hub:
      • vcvs <id> <gain>: voltage-controlled voltage source (SPICE E, dimensionless ratio, pins: p_out, n_out, ctrl_p, ctrl_n).
      • vccs <id> <gm>: voltage-controlled current source (SPICE G, transconductance in Siemens S, pins: p_out, n_out, ctrl_p, ctrl_n).
      • ccvs <id> <rm>: current-controlled voltage source (SPICE H, transresistance in Ohm, pins: p_out, n_out, ctrl_p, ctrl_n, with internal 0 V sense branch V_SENSE_<id>).
      • cccs <id> <gain>: current-controlled current source (SPICE F, dimensionless ratio, pins: p_out, n_out, ctrl_p, ctrl_n, with internal 0 V sense branch V_SENSE_<id>).
    • Add SIUnit::Siemens (S, siemens, mho) for conductance and transconductance quantities.
    • Expand SPICE netlist import to parse linear E, G, F, and H cards, automatically folding independent 0 V sense sources into controlled sources.
  • Voltage-controlled switch:
    • Add native voltage-controlled switch switch <id> [model] (SPICE S, pins: p1, p2, ctrl_p, ctrl_n).
    • Add verified built-in switch model KESSETSU_SW_V1 (1.0.0) with threshold voltage vt=0.5, hysteresis vh=0, on-resistance ron=1, and off-resistance roff=1Meg.
    • Support typed user switch model declarations: model switch <name> version=... license=... vt=... vh=... ron=... roff=... (mapping to SPICE .model ... SW).
    • Expand SPICE netlist import to parse S switch cards and inline .model ... SW definitions.
  • Zener breakdown diodes and model parameters:
    • Add built-in Zener breakdown diode models: 1N4733A (5.1 V), BZX84C3V3 (3.3 V), BZX84C5V1 (5.1 V), and BZX84C12 (12 V).
    • Add junction breakdown parameters bv, ibv, nbv, ibvl, and nbvl to the typed model diode parameter allowlist and SPICE import.
  • JFET device family:
    • Add native JFET component family: jfet <id> [model] (SPICE J, pins: d, g, s, default generic model 2N5457).
    • Add verified built-in generic JFET models: 2N5457 (alias J2N5457, N-channel NJF, version 1.0.0) and 2N5460 (P-channel PJF, version 1.0.0).
    • Add typed model jfet <name> njf|pjf allowlisting all 14 standard SPICE JFET parameters: vto, beta, lambda, rd, rs, cgs, cgd, pb, is, fc, b, kf, af, and tnom.
    • Expand SPICE netlist import to parse J JFET element cards and inline .model ... NJF|PJF definitions.
  • Coupled inductors and transformers:
    • Add couple <name> <ind1> <ind2> [<ind3> ...] <coefficient> statement for two-winding and uniform multi-winding mutual magnetic coupling (SPICE K cards), supporting coupling coefficients 0 < coefficient <= 1 and braced {...} parameter expressions.
    • Expand SPICE netlist import to parse K cards into canonical couple statements.
  • Explicit 4-terminal MOSFET bulk terminal:
    • Add optional 4th bulk terminal b to mosfet (d, g, s, optional b). When omitted in .kess, bulk defaults to source s in SPICE netlist generation (M... d g s s model) and 3-pin schematic symbols; when explicitly connected, all 4 pins are emitted (M... d g s b model) and rendered on 4-pin schematic symbols.
    • On SPICE import, 4-terminal MOSFET cards (M... d g s b model) with bulk tied to source fold to 3-pin mosfet, while explicit separate bulk nodes (b != s) preserve all 4 connected pins.
  • Exponential transient source waveform:
    • Add exp(v1, v2, td1, tau1, td2, tau2) exponential rise/fall transient waveform (SPICE EXP(...)) to typed independent source waveforms and SPICE import.
  • Biased small-signal AC sources:
    • Add biased small-signal AC source support: ac(amplitude, offset) generates SPICE DC <offset> AC <amplitude>, enabling small-signal AC sweeps around explicit DC operating points.
  • SPICE dialect ergonomics and clean-room compatibility corpus:
    • Add a 30-fixture clean-room SPICE compatibility corpus (core/tests/spice_corpus_contract.rs) validating dialect parsing, behavioral boundaries, and diagnostic fidelity.
    • Expand SPICE netlist import (kess import, CLI --input auto|spice, and MCP kessetsu_import_spice) for real-world netlists:
      • Bounded constant arithmetic and math formula evaluation in .param and {...} expressions (+, -, *, /, ^, **, pi, e, sqrt, sin, cos, tan, exp, ln, log10, abs, min, max, pow).
      • European RKM value notation for resistors and capacitors (4k7, 1u5, 2m2, 4r7).
      • Combined DC bias + AC stimulus (V1 in 0 DC 5 AC 1 0 -> ac(1, 5)).
      • 4-terminal BJT grounded-substrate folding when substrate is grounded (0/GND) or tied to emitter (with KES-N010 / KES-N011 warning).
      • Trailing SPICE instance parameter toleration on R/L/C (tc1, tc2, tol, ic, m, temp) and M (W, L, AD, AS, PD, PS, M) with KES-N011 warnings.

Op-Amp physical macromodel (KESSETSU_OPAMP_V2)

  • Upgrade KESSETSU_OPAMP_V1 (1.1.0) and subcircuit opamp to connect to vcc and vee and enforce anti-windup supply-rail output clamping (with safe symmetric clamping when V(vcc) <= V(vee)).
  • Add physical op-amp macromodel KESSETSU_OPAMP_V2 (1.0.0) modeling:
    • High-impedance differential input stage with open-loop gain gain=200k (106 dB),
    • Dominant-pole gain-bandwidth product (gbw=1MHz),
    • Slew-rate limiting (slew_rate=500k V/s or 0.5 V/µs),
    • Supply-rail output saturation headroom (vdrop=1V / rail_headroom relative to vcc and vee),
    • Linear output resistance (rout=50 Ω).
    • Physical boundary note: Accurately models rail headroom, dominant pole, slew rate, and linear output resistance (rout = 50 Ω); does not claim or model a hard nonlinear output-current limit, quiescent supply bias currents, or thermal/SOA shutdown.
  • Support optional rail_headroom, slew_rate, and rout parameters on subcircuit opamp.

Engineering study and design tools

  • Expose nominal engineering design calculators via kessetsu_tool MCP tool and kess tool CLI (divider and rc-lowpass / rc_lowpass) with exact analytical values, standard E12/E24 preferred selections, design equations, and ready-to-run .kess circuits.
  • Expose deterministic multi-condition parameter studies via kessetsu_study MCP tool (kessetsu_study_plan and kessetsu_study_run) and kess study CLI (sweep, monte_carlo, corners) for parameter sweeps, tolerance corners, temperature grids, and seeded Monte Carlo verification.
  • Add canonical 1.5 showcase circuits exercising new physical domains and verified subsystems:
    • examples/zener_shunt_regulator.kess: 12 V to 5.1 V shunt regulator using the built-in BZX84C5V1 Zener breakdown diode with .op and .tran regulation assertions.
    • examples/switched_sample_hold.kess: Switched capacitor sample-and-hold circuit using switch (model switch SW_SH), pulsed clocking, and a 1 µF hold capacitor.
    • examples/current_sense_amplifier.kess: Current-sense amplifier combining a linear ccvs sensor with the physical rail-clamped op-amp macromodel (KESSETSU_OPAMP_V2).
  • Register all showcase circuits into Web Hub preset examples with instant simulation and schematic inspection.

Public website, install, and onboarding UX

  • Redesign the landing page with high-signal progressive disclosure, moving from core verification and schematic visualization into practical agent workflows and real device models.
  • Implement an intent-first /install/ page with interactive AI client configuration generator for Claude Code, Claude Desktop, Cursor, and Windsurf, surfacing exact CLI and MCP setup commands.
  • Streamline getting-started documentation with beginner-friendly browser-first tutorial routing, clear path selection for netlist import versus AI coding agents, and cross-linked references.
  • Add Web Hub first-use onboarding banner and interactive empty-state canvas guidance to facilitate immediate exploration of presets and quick syntax references.

[1.4.0] — 2026-10-18

Built-in Model Context Protocol (kess mcp) server, direct SPICE netlist verification, and a redesigned Web Hub workspace with high-readability simulation plots and a tabbed/split right canvas.

Agent workflow and direct SPICE verification

  • Add kess mcp, a built-in stdio Model Context Protocol server exposing kessetsu_guide, kessetsu_capabilities, kessetsu_check, kessetsu_simulate, kessetsu_test, kessetsu_render_schematic, kessetsu_export, kessetsu_import_spice, kessetsu_tool, kessetsu_study_plan, kessetsu_study_run and the design_circuit prompt over the canonical kessetsu.cli.v1 JSON contract.
  • Upgrade KESSETSU_OPAMP_V1 (1.1.0) and subcircuit opamp to enforce physical supply-rail saturation across vcc and vee (DCLAMP + BRAIL_P/BRAIL_N), add KESSETSU_OPAMP_V2 (1.0.0, 1 V rail headroom, 0.5 V/µs slew rate, 50 Ω output resistance), and accept optional rail_headroom, slew_rate and rout parameters on subcircuit opamp.
  • Add global --input auto|kess|spice so check, compile, simulate, test, render and export accept supported SPICE netlists (.cir, .sp, .spice, .net, .ckt, .cki or dot-directive stdin) directly alongside .kess source and .kessreq files.
  • Expand SPICE import to convert inline .model cards (D, NPN, PNP, NMOS, PMOS) into typed model declarations, import 5-terminal X op-amp cards (KESSETSU_OPAMP_V1 or OPAMP) and Kessetsu's built-in op-amp subcircuit as native opamp components, tolerate first-line plain titles (KES-N010), and skip .control ... .endc blocks (KES-N012) and output/simulator-option directives (.print, .plot, .probe, .save, .meas, .options -> KES-N011) with warnings.
  • Allow .kessreq and inline assertions to reference original numeric SPICE node numbers such as V(1) and V(2) when testing imported SPICE netlists.
  • Add the Agent design workflow guide, surface MCP vs. CLI setup on the landing, installation and documentation pages, and unwrap outer Markdown JSON fences in browser AI proposal replies.

Web Hub workspace, plot readability and public documentation

  • Replace the three-column panel layout with a two-column workspace (Source on the left, and a right-hand canvas with Schematic | Simulation | Split view modes defaulting to Schematic). Move Run exclusively into the Simulation panel and replace the permanent restored-draft banner with an auto-dismissing toast notification.
  • Upgrade multi-plot simulation cards with a top header bar showing live hovered/pinned trace values (13px tabular monospace), a floating glassmorphic cursor readout badge inside the active SVG plot, and per-plot Focus / Show all expansion.
  • Add a live Convert SPICE Netlist modal under the File menu with side-by-side .kess preview, sample netlists, and 1-click opening in the editor, plus quick-insert snippet buttons (+ .op, + .ac, + .tran, + param, + assert).
  • Reorganize documentation navigation into five focused sections (Getting started, AI agents & workflows, Research & data, Reference, Help and updates) and remove redundant repository edit links from the documentation footer.

[1.3.1] — 2026-10-06

Maintenance update for the browser workflow, first-use guidance and installation. Language syntax, electrical and schematic semantics, and machine-contract versions remain unchanged from 1.3.0.

Dependency maintenance

  • Update the editor's DOMPurify override to 3.4.16, addressing GHSA-p98j-92pf-mc4p.
  • Keep guide links usable in the CLI archive's relocated supported-domain document.
  • Update the transitive source-map-js dependency to 1.2.2, addressing GHSA-68fv-2mgg-jv7q.

Web editor usability

  • Browser agent tasks include concise syntax guidance, a complete example and public references. Rejected replies and unsatisfied checks offer a copy/download correction task with unchanged human requirements, source identity and actual local feedback. Parse errors show their source line and a readable explanation; technical diagnostics remain available. Clipboard failure supports manual copying.

  • Landing emphasizes the complete circuit workflow rather than a calculator showcase. Existing calculators remain available from the footer; parameter studies and measured-data comparison have quiet contextual guide links instead of more competing primary actions.

  • Editor Help links directly to a public, task-focused problem report with reproducibility guidance and a reminder not to attach confidential circuits or proprietary model files.

  • Parameter studies include a one-action, complete six-case loaded-filter example that leaves the editor source untouched and asks before replacing retained study results. Study and CSV dialogs explain prerequisites, file types, example inputs and next actions; native-only device libraries explicitly direct users to the CLI.

  • Application menus support arrow keys, Home/End, submenu navigation and Escape focus return. Modal Tab navigation wraps within the dialog, Analyze dialogs return focus to their menu, and background Save/Run shortcuts are suppressed while a dialog is open. Failed lazy page/tool loading offers recovery instead of a blank screen; a research-tool failure can be dismissed without replacing the editor source.

  • CLI installation puts Ngspice prerequisites before simulation, includes simulator verification and platform-specific uninstall guidance, and offers a copyable complete external-agent task with fixed requirements, capabilities discovery and artifact output. A small llms.txt points agents to authoritative public guides.

  • Documentation topics are collapsed on narrow screens without requiring JavaScript; desktop navigation remains directly available.

  • SPICE import failures show the file, original-line diagnostics, a complete expandable report and direct retry/guide actions. Rejected imports preserve the circuit and save destination; a changed document during the file chooser is not replaced by a late selection.

  • Plot cursors select actual samples by physical axis rather than array index, including nonuniform transient timesteps, logarithmic AC and descending DC sweeps. Zoom follows the pointer in physical coordinates. DC axes show source-specific V/A units; AC magnitude states its 1 V/1 A reference and is not labeled as transfer gain. Default traces favor external voltages. Reduced assertion limits are kept in the measurement table, not drawn as misleading instantaneous waveform thresholds.

  • Sharing explains source snapshots and privacy, supports manual copying when clipboard access is blocked, and abandons pending link creation on close. Late creation/copy results cannot change a reopened sharing session; repeated Enter presses do not start parallel requests.

  • Export formats are grouped by purpose while retaining direct access to all nine formats. Download notices show filenames and complete Core warnings/loss notes, and explain that saving .kess is the way to reopen a project in Kessetsu.

  • Native Save tracks the exact document revision: edits made during a pending write remain unsaved, repeated Save shortcuts do not start concurrent writes, and an older circuit's destination cannot attach to a new document. Failed writes attempt to abort their stream.

  • Browser draft-storage failures now show a portable-copy recovery action. Failed open/import operations retain the existing save destination; late file reads and share-link creation cannot replace or rename a newer source revision.

  • Normal reload/page exit flushes the latest browser draft without waiting for the debounce; when unsaved work cannot be preserved, the editor requests the browser's leave-page warning.

  • The Analyze menu now describes each workflow in task-oriented language for first-time users.

  • The external-agent workflow is a guided three-step handoff with explicit privacy guidance, compact verification cards and separate collapsed sections for untrusted agent explanation and source diff. Actions now say what they do: test the proposed circuit, then apply it to the editor.

  • Local Core and simulation evidence is visually separated from the agent's own claims; completed runs with failed, errored, skipped or no assertions use a warning state instead of a success treatment. Applying one of those completed-but-unverified candidates requires a separate, explicit confirmation.

  • Agent replies, requirements and simulation evidence are bound to the exact candidate shown in the review. Editing or replacing a reply, changing the requested outcome, or changing the open circuit invalidates prior compile/simulation evidence so stale results cannot authorize another source revision.

  • Changing selected local model files also invalidates proposal review and test evidence, including changes made while the dialog is closed. Closing abandons pending task, reply-file and review work; late results cannot repopulate a reopened dialog. Completed review remains available when the source and model bindings are unchanged.

  • Proposal review keeps the human request visible, calls out the limits of agent-authored assertions, summarizes assertion, analysis, source, component and connection edits, and flags removed assertions or changed sources for closer review.

  • Automatic source validation is labeled Source valid so it is not confused with a completed simulation or satisfied engineering assertions.

  • The Simulation panel now gives a compact edit → run → inspect first-use path and links directly to the tutorial. A new circuit correctly says its included operating-point analysis is ready to run instead of incorrectly asking the user to add a simulation command.

  • Simulation and Schematic now explain checking, source errors and missing/mismatched model files with direct recovery actions. Source errors can restore a minimized Source panel without resetting its split sizes. A valid circuit without an analysis remains exportable, while Run stays disabled with analysis guidance; a completed run without assertions is explicitly unchecked.

  • Editing source clears obsolete results and offers Run again. Help, export, model selection and advanced-analysis dialogs link directly to their relevant guides. Built-in parameter-study examples no longer appear under local model files.

  • Landing and product-preview copy now describes source-based browser editing and encoded assertions precisely, and the landing export list includes BOM CSV and handoff JSON.

  • Public documentation now keeps the short first-circuit path separate from advanced analysis, leads the tutorial with a complete Web Hub walkthrough, and documents proposal invalidation and unchecked-apply behavior.

  • The first tutorial now matches the built-in RC example's five checks and explains restored drafts. Scope references distinguish single-run analyses from sampled/temperature studies, and introductory documentation lists all nine engineering export formats.

  • Import documentation now describes released 1.3.0 behavior with a complete RC netlist; the Cookbook distinguishes excerpts from whole circuits and portable Web model binding from native-only compatibility. CLI tutorial prerequisites are explicit.

  • Generated agent tasks now tell agents to remove unrelated placeholder circuitry, encode supported measurable requirements as assertions and avoid claiming an unperformed Kessetsu run.

[1.3.0] — 2026-09-26

Kessetsu 1.3.0 expands the verified circuit workflow beyond single-run design: repeatable multi-condition studies, local research-data comparison and fitting, supported SPICE import, physical-part handoff, larger-schematic navigation, installed agent discovery and provider-neutral proposal review. These workflows remain model- and scope-bounded; they do not claim hardware or manufacturing validation.

Provider-neutral agent proposal review

  • Analyze → Review agent proposal… creates a versioned, source-hash-bound task envelope for any external agent; Kessetsu does not upload source or require a provider account.
  • Returned kessetsu.agent-proposal.v1 JSON remains separate from the document while the user reviews its summary and line diff. Unknown schemas, stale base revisions, oversized payloads and invalid source fail without changing the open circuit.
  • A proposal must compile with verified schematic connectivity and complete a real local browser simulation before it can be accepted. Acceptance is explicit, marks the source unsaved and offers one-step Undo accepted proposal; closing or cancelling leaves the document untouched.
  • This handoff is a provider-independent review boundary, not a hosted model, autonomous design guarantee or claim that an agent's explanation is verified. Core simulation/assertion results remain separate from proposal text.

Agent capability discovery

  • kess capabilities --format json returns the deterministic kessetsu.capabilities.v1 installed-build manifest inside the normal CLI envelope, including command I/O behavior, live contract versions, calculator/language entry points, engineering metrics, export capabilities, workload limits, documentation links and a safe agent workflow.
  • Discovery is side-effect free and does not require a circuit or Ngspice. Export and measurement entries use their Core-owned catalogs rather than a separate frontend list.
  • Unsupported-metric diagnostics now use the same complete catalog and include the dynamic rise_time, fall_time, settling_time, overshoot and energy metrics.

Schematic navigation and quality

  • The Web schematic inspector can find and center components or named nets, follow logical pins, highlight a complete net, show model provenance and navigate structured reusable-block groups.
  • Multiway aligned nets move an obstructed branch hub to a clear pin escape, avoiding duplicate wire segments and stacked junction dots without changing canonical connectivity.
  • KiCad handoff schematics use roomier native spacing, hide retained pin metadata by default and place named-net labels on short outward stubs so editable exports open without text collisions.
  • The visual and real KiCad/LTspice corpus now includes loaded filters, transistor drivers and independently parameterized reusable filter/amplifier instances.

Physical part identity

  • part statements attach optional manufacturer, MPN, footprint, complete logical-pin mapping and user notes plus condition-qualified provided voltage/current/dissipation limits to an electrical component without changing its value, model or connectivity.
  • Core validates assignments against catalog pins, preserves module-instance identity and exposes kessetsu.physical-parts.v2 separately in Circuit IR. Unknown/incomplete mappings and malformed or condition-free limits fail closed.
  • Physical metadata and reusable-block navigation advance compile reports to kessetsu.compile.v9; simulation netlists remain byte-identical when only metadata changes.
  • Native and Web simulation expose kessetsu.part-stress.v1: model stress versus user-provided limits, including conditions/citation and explicit unavailable states. This advisory comparison is separate from requirements, exit status, datasheet compliance and safe-operating-area claims.
  • Deterministic BOM CSV groups matching selections and keeps unresolved/incomplete rows visible; kessetsu.handoff.v2 also records provided ratings while retaining IR identity, footprint readiness and exact model dependencies.
  • KiCad uses the declared footprint and physical pad numbers only with a complete pin map. A bare footprint remains visible in BOM/handoff evidence but is not silently attached to the schematic.
  • The shared export contract advances to kessetsu.export.v3; CLI and Web expose BOM CSV and handoff JSON through the existing Export flow.
  • Physical components retain structured reusable-block ancestry independently of their canonical flattened electrical identifiers. Existing source-only share links from compatible Core revisions are recompiled rather than rejected.

Supported SPICE netlist import

  • kess import converts a declared Ngspice-compatible subset into ordinary editable .kess and recompiles it through the canonical Core before writing output.
  • Initial coverage includes literal R/C/L, independent DC/AC/SINE/PULSE/PWL voltage/current sources, selected built-in diode/BJT/MOSFET models and OP/TRAN/AC/DC analyses.
  • Original component/net names receive deterministic reversible mappings. SPICE numeric suffixes, including its case-insensitive milli M, are normalized without changing electrical values.
  • Literal .param NAME=value relationships remain typed editable parameters; Kessetsu infers the unit from supported uses and rejects unused or dimensionally conflicting parameters.
  • Source-embedded .SUBCKT topologies become editable module definitions and root X cards become use instances. Explicit ports, local connectivity, literal typed defaults and named overrides are retained; unsupported nesting or implicit globals fail instead of being flattened.
  • Unsupported directives, control blocks, include paths, models, expressions and device families fail with source-line diagnostics instead of producing a partial circuit.

Portable research packages

  • kess study package writes a new atomic research folder with the exact specification and source, complete result JSON, summary/full-data CSV, labeled SVG, printable HTML and rerun guide.
  • kessetsu.research-package.v1 records every payload hash, plotted analysis/signal/case, model citation/license/hash, original simulator and solver identity, and interpretation limits.
  • Redistributable external models retain their exact relative paths; prohibited model bodies are never copied and remain precise user-supplied dependency requirements.

Reproducible memristor protocol

  • A 24-case signed pulse study characterizes amplitude, duration, starting state, modeled resistance change, current and energy for the exact bundled threshold-model dependency.
  • A separate 16-case timestep-refinement study exposes bounded numerical sensitivity, while a held-out stimulus remains separate from the displayed sweep rather than influencing it.
  • An executable regression, headless notebook and public guide retain explicit units, model identity, solver evidence and the distinction between synthetic simulation and physical validation.

Finite calibration and validation

  • Core-owned kessetsu.fit.v1 evaluation selects only among completed finite study candidates using declared calibration observations; holdout validation never influences selection.
  • Dimensionless weighted RMS scoring uses explicit per-signal uncertainty and weight while preserving complete residual comparisons, score masks, failures, case/data/model/solver identities, boundary hits and near-equivalent candidates in kessetsu.fit-result.v1.
  • kess fit evaluate, typed Python tables and a headlessly executable synthetic notebook share the same contract. The workflow makes no continuous/global optimum, physical-mechanism, identifiability or extrapolation claim.
  • Typed external subcircuit parameters can be swept as ordinary root study axes, allowing exact hash-bound local models to participate without editing their model text.

Typed external model parameters

  • External subcircuits may expose a bounded, unit-typed allowlist of existing .SUBCKT parameters; instances can bind literals or root parameter expressions without editing model text.
  • Resolved per-instance values and provenance remain in Circuit IR and survive canonical SPICE, LTspice, KiCad and Schematic JSON export. Unknown names, unit mismatches, duplicates and parameters absent from the exact hash-bound library fail closed.
  • Compile reports advance to kessetsu.compile.v6, canonical schematics to kessetsu.schematic.v3, and model manifests/locks to v3; v4/v5 source shares remain explicitly supported.

Research-data foundation

  • Local kess data preview/import/compare and shared Core/WASM contracts for explicitly mapped CSV, engineering units, calibration, raw-source identity and missing-row accounting.
  • Scalar reference comparison with explicit windows/shifts, interpolation and coverage; full residuals and sample-weighted bias, MAE, RMSE and maximum error.
  • Local Web research-data workspace for CSV preview, explicit mapping, two-dataset overlay, residual metrics and evidence download without changing the open circuit or uploading data.
  • Typed projection of the current successful transient, AC-magnitude or DC simulation into the same research-data comparison flow, retaining solver/result/vector provenance.
  • Native --include simulation evidence and kess data from-simulation close Web/CLI projection parity without moving interpolation or residual semantics into adapters.
  • Optional local Python package for safe CLI invocation, exact contract validation, typed simulation/study/research tables and pandas conversion; includes a headlessly verified Jupyter workflow from circuit simulation through residual evidence and plots.
  • Synthetic tutorial files and detailed research-data guide. Arbitrary direct study-result comparison remains outside this data-command surface.

Local parameter studies

  • Shared versioned study specifications and deterministic list/linear/log grids, revisions, temperatures, nominal/corner and seeded uniform/Gaussian tolerance studies.
  • Native kess study create/plan/run/export, durable per-case checkpoints and cancellation/resume guarded by source, requirements, models and solver/Core build identity.
  • Web Analyze → Parameter study: configure, run, stop/resume, inspect failures, compare reports, apply parameters and download full JSON/numeric CSV, summary CSV, SVG or HTML reports.
  • Finite-grid objectives retain all outcomes and choose only feasible evaluated candidates; no global-optimum, hardware-validity or production-yield claims.
  • Explicit-window rise/fall/settling time, directional overshoot and signed integrated energy; measurement contract advances to kessetsu.measurement.v3. Legacy metrics retain semantics.
  • Explicit budgets and detailed study guide.

Compatibility and upgrade

  • Existing literal circuits remain valid. Kessetsu 1.3.0 advances compile reports to kessetsu.compile.v9, canonical schematics to kessetsu.schematic.v3, model manifests/locks to v3, engineering measurements to v3 and exports to kessetsu.export.v3; the stable kessetsu.cli.v1, simulation and assertion envelopes are unchanged.
  • Compatible v4/v5 source-share links are recompiled through the current Core. Unknown future schemas still fail closed. Local external-model bodies and provider credentials are never embedded in share links or agent-task envelopes.
  • Install with the normal guided command to upgrade. Release archives retain complete source, documentation, examples, Python adapter, notices, exact version metadata and per-artifact hashes.

[1.2.0] — 2026-09-18

Website and documentation

  • Simplified landing copy and route-specific loading messages.
  • Refreshed landing schematic from the shared Core instead of a hand-drawn mockup.
  • On-site changelog, documentation navigation and section index, plus a complete Web editor guide.
  • Removed internal roadmap, historical evaluation reports and operational notes from current public source and new release packages; technical test specifications remain test inputs.
  • Clear Windows installation/session guidance with a directly usable launcher path.

Compatibility

Existing literal circuits continue to work. Upgrade CLI and Web usage to 1.2.0 for parameters, new AC metrics and browser local models. Compile reports now use kessetsu.compile.v5 and measurements kessetsu.measurement.v2; CLI, assertions and requirements envelopes are unchanged. Existing v4 source-share links are recompiled; unknown future schemas are rejected. Independent .kessreq limits remain literal. Local model files must be supplied separately; the official PSpice OPA197 model remains native-only. Model identity is not hardware validation.

Local external devices and model files

  • Catalog-backed comparator and two-terminal external subcircuits, instantiated with device; shared typed pins, ERC, schematic and all seven export formats.
  • Explicit local model selection in Web Circuit details. Exact file/hash/entry validation, portable Ngspice library checks and native-only compatibility diagnostics before execution. Files stay in memory, never in drafts, share URLs, manifests or ordinary model-body exports.
  • Generic comparator and published threshold-memristor examples, with exact files/defaults, attribution/license and electrical comparison coverage. Existing official OPA197 stays user-acquired/native-only, not redistributed or substituted.
  • Optional transient uic for model initial conditions; ordinary analyses retain their previous serialization and behavior. External header defaults/continuations are supported.
  • Fix repeated primitive assertion limits producing duplicate Ngspice measurement records; each assertion retains its own limit and evaluation.

Reusable circuit examples

  • Add complete RC filter and non-inverting amplifier examples with independently configured instances, fixed simulation assertions and access through File → Examples in Web.
  • Preserve structured module-instance paths on virtual IR interfaces, including literal blocks without parameter provenance; electrical IDs and flattened backend topology remain unchanged.
  • Document ports versus parameters, defaults, loading, model assumptions and portable source-embedded block identity in the cookbook. No registry or external block imports.

Parameter diagnostics and compilation limits

  • Preserve actual declaration/module-input positions through nested elaboration without changing default provenance or guessing parameter locations from similarly named comments.
  • Bound source size, parsed/expanded statements and expression work; share node accounting across numeric roles and reject unsupported nested waveform calls without parser recursion.
  • Preserve supported literal/quoted waveforms, existing source examples and backend semantics.

Reproducible parameter inputs

  • Add shared versioned root numeric inputs and repeatable CLI --param NAME=VALUE for circuit checking, compilation, simulation, tests and exports, without editing source files.
  • Recalculate dependent defaults, reject unknown/duplicate/invalid inputs before writes or simulation and retain original defaults/effective override provenance in typed IR.
  • Return portable effective .kess through --include effective-source; expose the same pure input contract in WASM without adding persistent editor override state.
  • Preserve line endings/comments during materialization and allow trailing // comments without consuming a statement's required line ending.

Parameterized inline measurements

  • Accept {expression} in design-owned assertion thresholds and supported numeric metric arguments: time windows, target/reference frequency, THD fundamental and clipping rails.
  • Resolve typed IR quantities before simulation; preserve literal signal/device/policy names, existing measurement semantics and sorted assertion-field provenance.
  • Keep independent .kessreq numeric fields literal-only, with explicit expression rejection.

Parameterized excitation and analyses

  • Accept {expression} in all numeric slots of unquoted ac, sine, sine_ac, pulse and pwl voltage/current sources, with lexical module parameter binding.
  • Accept expressions for transient step/stop, AC points/start/stop and DC start/stop/step. Keep scale keywords/source names literal and require positive integral AC point counts.
  • Resolve typed values directly into IR; retain waveform-field and optional sorted analysis-field provenance without changing literal backend output.

CLI output protection

  • Check netlist and model-lock destinations before either write. Reuse byte-identical locks without rewriting; require --force for different existing lock contents.
  • Reject source/lock and netlist/lock destination aliases even with --force.

Explicit AC measurements

  • Added gain_at(out,in,frequency), lower_cutoff(out,in[,reference_frequency]) and upper_cutoff(out,in[,reference_frequency]) to the shared CLI/Web evaluator.
  • Interpolate magnitude along log frequency without extrapolation; require explicit references for ambiguous disjoint bands and report missing edges as errors.
  • Measurement contract v2 adds these metrics without changing legacy metrics or the CLI/assertion/requirements envelopes. Editor completion and hover describe the new calls.

Schematic geometry and editable exports

  • Verify actual conductive paths, pin contacts, isolated crossings and matching semantic labels, rather than trusting wire net tags. Invalid drawing geometry blocks export.
  • Preserve pin escape space, separate crowded components and keep reference/value blocks close to their symbols. Negative supply markers and their captions point outward.
  • Map LTspice symbols to native rotations/mirrors and reroute from their actual pins; preserve orthogonal paths and validate the resulting geometry before export.
  • Place KiCad reference/value properties from the shared schematic annotations and draw conductive joins explicitly. Added an original dense-bias regression circuit.

Builtin diode portability

  • Corrected 1N4148, 1N4007 and the default diode path to use portable Ngspice diode directives without descriptive or non-enforced rating fields. Electrical coefficients are unchanged; repaired builtin models have provenance version 1.0.1 and new content hashes, retaining their legacy/unverified attribution. Exact model packages are unchanged.
  • Added real native/browser OP regression coverage for both named models and the default.

Parameterized circuit foundation

  • Independent module parameter scopes and named use overrides, with recalculated defaults, typed caller binding and structured instance-path/override provenance.

  • Declared module ports in IR/ERC, scoped local nets and flattened-path collision errors. Virtual module ports are excluded from physical schematic-pin expectations, without weakening physical connection checks.

  • Top-level typed param declarations and bounded, unit-checked arithmetic in passive and DC-source values.

  • Parameter/dependency and resolved-field provenance in kessetsu.parameters.v1; all electrical and drawing backends still consume resolved Circuit IR.

  • Source completion/highlighting without new editor panels; compile contract v5 with explicit v4 source-share compatibility and unchanged exact-package checks.

  • Prefix/exponent overflow/underflow validation and bounded module recursion/expansion diagnostics.

Parameterized module analyses/assertions must be placed at the circuit root until their context/target handling is implemented.

[1.1.0] — 2026-09-16

Circuit tools

  • Shared nominal divider/RC calculations with typed SI inputs, exact/E12/E24 values, achieved results and editable circuit templates.
  • kess tool divider and kess tool rc-lowpass with the existing JSON envelope and explicit .kess output.
  • Local browser tools at /tools/, with generated-circuit download, editor continuation and recovery of the previous browser circuit.
  • Discoverable toolkit links on desktop/mobile landing pages; simulation without assertions shows completion instead of a misleading 0/0 requirements summary.

Web and discovery

  • Build-time HTML for the existing landing and installation pages, with distinct route titles and descriptions.
  • Public guides and references at /docs/, generated from the reviewed Markdown sources without a JavaScript requirement; sitemap covers all public content pages.
  • GitHub project description, topics and canonical product homepage updated. No analytics or circuit uploads added.

[1.0.1] — 2026-09-16

Distribution

  • Guided CLI installation page with OS selection, copyable commands, first-circuit download, simulator prerequisites, updates, and manual fallback.
  • Per-user Windows and POSIX bootstrappers that select official stable releases, verify archive/executable integrity and version, configure PATH, preserve previous bundles, and refuse unmanaged paths. The CLI binary remains the independently released stable version.

Fixed

  • LTspice export emits dotted analysis directives and correct DC-source references. The first analysis is active; additional analyses remain selectable comments with an explicit warning. Target-application smoke compares pin connectivity and component data rather than reference presence alone.
  • Windows ZIP packaging uses portable slash-separated entries on both Windows PowerShell 5 and PowerShell 7, preserving strict installer path validation.

Documentation

  • Concise public roadmap and documentation index, with account-specific execution prose removed from published reports while preserving evaluation outcomes and limitations.
  • Reviewed public-document manifest and focused publication checks for future release packaging.

[1.0.0] — 2026-09-16

First public release.

Product

  • One Rust Core shared by native CLI and WebAssembly.
  • Zero-account Web Hub with live compile/ERC, canonical schematic, real browser Ngspice simulation, plots, assertions, seven export formats and versioned share URLs.
  • Local Web document workflow with .kess open, native in-place Save and Save As on Chromium, browser-local Save plus explicit .kess download on Firefox and other fallback browsers, explicit naming, deterministic export filenames and versioned draft recovery.
  • Project-level actions stay in the global toolbar, while the Simulation panel owns Run/Cancel, execution state, plots and requirement results.
  • Selected lowercase Kessetsu wordmark, signal-line identity and matching favicon with a self-hosted, license-bundled Inter glyph subset.
  • Agent-oriented CLI with stdin, kessetsu.cli.v1 JSON, stable diagnostics/exit codes and safe artifact writes.
  • Evaluator-owned kessetsu.requirements.v1 files with exact-byte SHA-256 provenance and optional pinning for supervised agent/CI loops.
  • Fail-closed test semantics: zero assertions cannot pass, unknown metrics fail before simulation, and ambiguous repeated analyses are rejected without breaking distinct DC-source sweeps.
  • Complete typed PWL source parsing with dimensional values and non-negative, strictly increasing time points.
  • OP, transient, AC and DC sweep datasets; engineering metrics for gain, cutoff/bandwidth, phase/frequency, output power, efficiency, THD, clipping and dissipation.
  • Typed builtin/user/package models with exact versions, hashes, licenses and lockfile provenance.
  • Typed, hash-bound external op-amp subcircuit references for native CLI simulation, including safe source-relative resource binding, PSpice compatibility, deterministic lock/provenance metadata, and explicit no-embedding export behavior.
  • Deterministic Schematic IR with connectivity and visual-quality gates.
  • SVG, PNG, PDF, Schematic JSON, SPICE, KiCad and LTspice export.
  • RC, gain-stage and four-stage 8 Ω / approximately 2 W power-amplifier benchmark parity across CLI and Web.

Distribution

  • Windows x86-64 bundle with Ngspice 46 sidecar.
  • Linux x86-64, macOS x86-64 and macOS arm64 CLI bundles with verified system-Ngspice discovery.
  • Absolute bundled/explicit/PATH simulator provenance and a portable Ngspice MOS1 KESSETSU_PMOS_V1@1.0.1 directive verified across supported runners.
  • Per-artifact SHA-256, release manifest and clean-machine simulation smoke workflow.
  • AGPL-3.0-only public license with a separately negotiated commercial-license path; license/source notices are bundled in CLI and Web distributions.

Migration

This is the first versioned release, so there is no earlier public schema to migrate. Prototype users should note that render is now functional, editable export uses kess export --target ..., compile reports are kessetsu.compile.v4, and browser share links require kessetsu.share.v1; unknown older payloads fail closed.