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
WorkflowDialogwizards 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) whereCopy agent taskandDownload task fileautomatically advance toProposal,Paste from clipboard & checkandUpload reply file…verify and advance toReview, and simulation verification (Run simulation) and applying changes (Apply to editor) remain explicit review actions.
- Parameter study (
- Standardize all Web Hub Analyze tools on page-like multi-step
- Automated bundled model binding and local model management:
- Automatically bind bundled
.libreference 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.
- Automatically bind bundled
- 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:
ResearchDataPartsfor CSV preview, column mapping, and residuals;StudyStepsfor parameter axes, tolerance configs, and candidate grids; andAgentProposalPartsfor task packaging, proposal verification, and diagnostic recovery.
- Decompose large Web Hub dialog components into focused submodules:
- Core and CLI module organization:
- Modularize the SPICE netlist import subsystem into dedicated
spice_importsubmodules for tokenization, card parsing, expression evaluation, and device folding. - Decompose the native
kessCLI into focused command support modules across test, simulation, study, data, and export pipelines.
- Modularize the SPICE netlist import subsystem into dedicated
- Schematic symbol reveal:
- Extend schematic-to-source symbol reveal and canvas selection highlighting for
jfet,couple, anddevicecomponents.
- Extend schematic-to-source symbol reveal and canvas selection highlighting for
- Measurement and schematic rendering polish:
- Add
pk2pk(with aliasesp2pandvpp) as a reduction metric (max - minover 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.
- Add
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 VDMOSIRF9540, and asymmetric/symmetric rail-headroom op-amp macromodelsLM358(vdrop_high=1.5V,vdrop_low=20mV,GBW=1MHz,SR=0.5V/us,rout=50Ohm) andTL072(vdrop_high=1.5V,vdrop_low=1.5V,GBW=3MHz,SR=13V/us,rout=50Ohm) across Core and SPICE import (X... LM358|TL072and inline.model ... VDMOSwithpchan/nchan). - Support case-insensitive diode pin aliases
anode/a(-> p1) andcathode/k(-> p2) inconnectstatements,partpin_mapstrings, andV(D1.anode, D1.cathode)/V(D1.a, D1.k)measurements across all analyses. - Enrich
KES-C003unknown-model diagnostics with available built-in model names and typedmodel/external_subcircuitsyntax hints.
- Add built-in indicator LED diode models (
- 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::DcSweepcurrent evaluation so capacitors (I(C1)) return steady-state zero current rather than differentiating against the swept voltage/current axis, andcurrent_sourceuses its steady-state DC level. - Implement
Waveform::Pulsecurrent evaluation andI(Switch)/P(Switch)branch current and power evaluation across analyses.
- Support
- CLI & MCP share links (
kess share,kessetsu_share_link) and--measuresimulation queries:- Add
core/src/share.rs(kessetsu.share.v1/kessetsu.share_link.v1),kess shareCLI command,kessetsu_share_linkMCP tool,share_urlinkess tool/kessetsu_toolcalculator outputs, and Copy share link on Web Hub/tools/. - Add repeatable
--measure <EXPR>onkess simulateandmeasure: string[]onkessetsu_simulate, plus automaticV(<net>)andI(<comp>)operating-point summary population whenmeasurementswould otherwise be empty. - Return the full
kessetsu.spice-import.v1report fromkessetsu_import_spice, and automatically strip inlineassertlines inkessetsu_testwhen externalrequirementsorrequirements_pathis provided.
- Add
- Interactive schematic inspector, quick-tweak, derived plot traces, and Monaco completions:
- Upgrade the Web Hub
.schematic-navigator(SchematicPanel.tsx) with live simulatedΔV,I, andPreadouts, 1-clickPlot V/Plot I/Plot Pand+ Comparewaveform overlays, wire segment click hit-testing, and inline-10%/+10%component value quick-tweak with automatic simulation rerun. - Synthesize derived
I(...),P(...), and differentialV(A, B)plot traces inplot.tsandResultsPanel.tsx, preserve selected dataset tabs and trace overlays across reruns, expand context-aware Monaco completions and hover docs, and accept markdown-fenced or raw.kesssource in Work with an AI agent… proposal paste.
- Upgrade the Web Hub
- Differential net voltages and periodic/harmonic assertions:
- Support differential net voltage
V(NET_A, NET_B)(including ground and mixedcomponent.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 offrequency, 1 or 3 args),period(1 or 3 args), andduty_cycle/duty(1 or 3 args) periodic transient metrics, and extendthdto accept 2-argument (thd(signal, fundamental)), 4-argument (thd(signal, fundamental, start, stop)), and 5-argument (thd(signal, fundamental, start, stop, hann)) forms.
- Support differential net voltage
- Node initial conditions (
initial) and flexiblepwlsyntax:- Add
initial V(NET) = <voltage>(literal or{expr}, including module-local nets) with ERC validation, SPICE.ic V(<net>)=<voltage>generation before.control, LTspice!.icexport, and round-trip SPICE.icimport. - 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 forcurrent_sourcePWL waveforms.
- Add
- 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), andJ201(NJF JFET) models across Core and SPICE import collision handling, plus native Ngspice@J_<id>[id]drain current saving.
- Add built-in
- Engineering calculators and Monaco editor support:
- Add
non_inverting_opamp(/tools/non-inverting-opamp/) andzener_regulator(/tools/zener-regulator/) calculators alongsidedividerandrc-lowpassacross Core,kess toolCLI,kessetsu_toolMCP, and Web Hub/tools/. - Add Monaco syntax highlighting and completions for
initial,freq,period,duty_cycle, andduty.
- Add
[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 (SPICEE, dimensionlessratio, pins:p_out,n_out,ctrl_p,ctrl_n).vccs <id> <gm>: voltage-controlled current source (SPICEG, transconductance in SiemensS, pins:p_out,n_out,ctrl_p,ctrl_n).ccvs <id> <rm>: current-controlled voltage source (SPICEH, transresistance inOhm, pins:p_out,n_out,ctrl_p,ctrl_n, with internal 0 V sense branchV_SENSE_<id>).cccs <id> <gain>: current-controlled current source (SPICEF, dimensionlessratio, pins:p_out,n_out,ctrl_p,ctrl_n, with internal 0 V sense branchV_SENSE_<id>).
- Add
SIUnit::Siemens(S,siemens,mho) for conductance and transconductance quantities. - Expand SPICE netlist import to parse linear
E,G,F, andHcards, automatically folding independent 0 V sense sources into controlled sources.
- Add native linear SPICE dependent sources to Circuit IR, parser, SPICE netlist generation, Schematic IR, and Web Hub:
- Voltage-controlled switch:
- Add native voltage-controlled switch
switch <id> [model](SPICES, pins:p1,p2,ctrl_p,ctrl_n). - Add verified built-in switch model
KESSETSU_SW_V1(1.0.0) with threshold voltagevt=0.5, hysteresisvh=0, on-resistanceron=1, and off-resistanceroff=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
Sswitch cards and inline.model ... SWdefinitions.
- Add native voltage-controlled switch
- 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), andBZX84C12(12 V). - Add junction breakdown parameters
bv,ibv,nbv,ibvl, andnbvlto the typedmodel diodeparameter allowlist and SPICE import.
- Add built-in Zener breakdown diode models:
- JFET device family:
- Add native JFET component family:
jfet <id> [model](SPICEJ, pins:d,g,s, default generic model2N5457). - Add verified built-in generic JFET models:
2N5457(aliasJ2N5457, N-channelNJF, version1.0.0) and2N5460(P-channelPJF, version1.0.0). - Add typed
model jfet <name> njf|pjfallowlisting all 14 standard SPICE JFET parameters:vto,beta,lambda,rd,rs,cgs,cgd,pb,is,fc,b,kf,af, andtnom. - Expand SPICE netlist import to parse
JJFET element cards and inline.model ... NJF|PJFdefinitions.
- Add native JFET component family:
- Coupled inductors and transformers:
- Add
couple <name> <ind1> <ind2> [<ind3> ...] <coefficient>statement for two-winding and uniform multi-winding mutual magnetic coupling (SPICEKcards), supporting coupling coefficients0 < coefficient <= 1and braced{...}parameter expressions. - Expand SPICE netlist import to parse
Kcards into canonicalcouplestatements.
- Add
- Explicit 4-terminal MOSFET bulk terminal:
- Add optional 4th bulk terminal
btomosfet(d,g,s, optionalb). When omitted in.kess, bulk defaults to sourcesin 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-pinmosfet, while explicit separate bulk nodes (b != s) preserve all 4 connected pins.
- Add optional 4th bulk terminal
- Exponential transient source waveform:
- Add
exp(v1, v2, td1, tau1, td2, tau2)exponential rise/fall transient waveform (SPICEEXP(...)) to typed independent source waveforms and SPICE import.
- Add
- Biased small-signal AC sources:
- Add biased small-signal AC source support:
ac(amplitude, offset)generates SPICEDC <offset> AC <amplitude>, enabling small-signal AC sweeps around explicit DC operating points.
- Add biased small-signal AC source support:
- 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 MCPkessetsu_import_spice) for real-world netlists:- Bounded constant arithmetic and math formula evaluation in
.paramand{...}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 (withKES-N010/KES-N011warning). - Trailing SPICE instance parameter toleration on
R/L/C(tc1,tc2,tol,ic,m,temp) andM(W,L,AD,AS,PD,PS,M) withKES-N011warnings.
- Bounded constant arithmetic and math formula evaluation in
- Add a 30-fixture clean-room SPICE compatibility corpus (
Op-Amp physical macromodel (KESSETSU_OPAMP_V2)
- Upgrade
KESSETSU_OPAMP_V1(1.1.0) andsubcircuit opampto connect tovccandveeand enforce anti-windup supply-rail output clamping (with safe symmetric clamping whenV(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=500kV/s or0.5 V/µs), - Supply-rail output saturation headroom (
vdrop=1V/rail_headroomrelative tovccandvee), - 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.
- High-impedance differential input stage with open-loop gain
- Support optional
rail_headroom,slew_rate, androutparameters onsubcircuit opamp.
Engineering study and design tools
- Expose nominal engineering design calculators via
kessetsu_toolMCP tool andkess toolCLI (dividerandrc-lowpass/rc_lowpass) with exact analytical values, standard E12/E24 preferred selections, design equations, and ready-to-run.kesscircuits. - Expose deterministic multi-condition parameter studies via
kessetsu_studyMCP tool (kessetsu_study_planandkessetsu_study_run) andkess studyCLI (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-inBZX84C5V1Zener breakdown diode with.opand.tranregulation assertions.examples/switched_sample_hold.kess: Switched capacitor sample-and-hold circuit usingswitch(model switch SW_SH), pulsed clocking, and a 1 µF hold capacitor.examples/current_sense_amplifier.kess: Current-sense amplifier combining a linearccvssensor 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 exposingkessetsu_guide,kessetsu_capabilities,kessetsu_check,kessetsu_simulate,kessetsu_test,kessetsu_render_schematic,kessetsu_export,kessetsu_import_spice,kessetsu_tool,kessetsu_study_plan,kessetsu_study_runand thedesign_circuitprompt over the canonicalkessetsu.cli.v1JSON contract. - Upgrade
KESSETSU_OPAMP_V1(1.1.0) andsubcircuit opampto enforce physical supply-rail saturation acrossvccandvee(DCLAMP+BRAIL_P/BRAIL_N), addKESSETSU_OPAMP_V2(1.0.0, 1 V rail headroom, 0.5 V/µs slew rate, 50 Ω output resistance), and accept optionalrail_headroom,slew_rateandroutparameters onsubcircuit opamp. - Add global
--input auto|kess|spicesocheck,compile,simulate,test,renderandexportaccept supported SPICE netlists (.cir,.sp,.spice,.net,.ckt,.ckior dot-directive stdin) directly alongside.kesssource and.kessreqfiles. - Expand SPICE import to convert inline
.modelcards (D,NPN,PNP,NMOS,PMOS) into typedmodeldeclarations, import 5-terminalXop-amp cards (KESSETSU_OPAMP_V1orOPAMP) and Kessetsu's built-in op-amp subcircuit as nativeopampcomponents, tolerate first-line plain titles (KES-N010), and skip.control ... .endcblocks (KES-N012) and output/simulator-option directives (.print,.plot,.probe,.save,.meas,.options->KES-N011) with warnings. - Allow
.kessreqand inline assertions to reference original numeric SPICE node numbers such asV(1)andV(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 (
Sourceon the left, and a right-hand canvas withSchematic | Simulation | Splitview modes defaulting toSchematic). MoveRunexclusively into theSimulationpanel 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 (
13pxtabular monospace), a floating glassmorphic cursor readout badge inside the active SVG plot, and per-plotFocus/Show allexpansion. - Add a live
Convert SPICE Netlistmodal under theFilemenu with side-by-side.kesspreview, 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.txtpoints 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
.kessis 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.v1JSON 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 jsonreturns the deterministickessetsu.capabilities.v1installed-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,overshootandenergymetrics.
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
partstatements 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.v2separately 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.v2also 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 importconverts a declared Ngspice-compatible subset into ordinary editable.kessand 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=valuerelationships remain typed editable parameters; Kessetsu infers the unit from supported uses and rejects unused or dimensionally conflicting parameters. - Source-embedded
.SUBCKTtopologies become editablemoduledefinitions and rootXcards becomeuseinstances. 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 packagewrites 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.v1records 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.v1evaluation 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
.SUBCKTparameters; 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 tokessetsu.schematic.v3, and model manifests/locks to v3; v4/v5 source shares remain explicitly supported.
Research-data foundation
- Local
kess data preview/import/compareand 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 simulationevidence andkess data from-simulationclose 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 tokessetsu.schematic.v3, model manifests/locks to v3, engineering measurements to v3 and exports tokessetsu.export.v3; the stablekessetsu.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
uicfor 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=VALUEfor 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
.kessthrough--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
.kessreqnumeric fields literal-only, with explicit expression rejection.
Parameterized excitation and analyses
- Accept
{expression}in all numeric slots of unquotedac,sine,sine_ac,pulseandpwlvoltage/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
--forcefor 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])andupper_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,1N4007and 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 version1.0.1and 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
useoverrides, 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
paramdeclarations 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 dividerandkess tool rc-lowpasswith the existing JSON envelope and explicit.kessoutput.- 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
.kessopen, native in-place Save and Save As on Chromium, browser-local Save plus explicit.kessdownload 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.v1JSON, stable diagnostics/exit codes and safe artifact writes. - Evaluator-owned
kessetsu.requirements.v1files 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.1directive 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.