Releases: lfnovo/construct
Release list
Construct v0.3.2
Construct v0.3.2 — Review responsiveness preview
This preview fixes slow typing in Review comments and a blank-view failure when adding comments across formatted text.
Highlights
- Comment typing no longer reprocesses the entire Markdown document or restarts unchanged code, image, and diagram components.
- Declarative highlights preserve React's ownership of the document, including overlapping comments and repeated text in HTML tables.
- Document rendering failures offer Open Source and Retry view while preserving the tab buffer; Source failures offer Retry without a redundant mode switch. Review retains the pending selection and comment in memory through recovery or a Source/Review round trip while the same tab stays active.
- Existing review data remains compatible. Add comment updates the buffer; Save remains explicit.
- Local, bounded render-failure diagnostics contain only the affected view mode.
Downloads
Choose the desktop installer for your platform, or a standalone CLI archive. GitHub's source archives are not installers.
- macOS Apple Silicon:
Construct_0.3.2_aarch64.dmg - macOS Intel:
Construct_0.3.2_x64.dmg - Windows x64:
Construct_0.3.2_x64-setup.exe - Standalone CLI: the
construct_0.3.2_<target>.tar.gzor Windows.zipartifact. - Linux x64 ships the standalone OKF linter only, with a glibc 2.35 baseline; no Linux desktop app or MCP is included.
Before installation, compare the downloaded file's SHA-256 with SHA256SUMS. macOS/Linux users can run shasum -a 256 -c SHA256SUMS from a directory containing every listed artifact; Windows users can compare Get-FileHash -Algorithm SHA256 with the manifest.
Preview limitations
macOS packages are ad-hoc signed, not Developer ID signed/notarized. Windows packages are unsigned. These artifacts are not trusted stable distribution and may trigger operating-system warnings. There are no automatic updates.
Validation status
- Full release workflow passed for macOS Apple Silicon, macOS Intel, Windows x64 and Linux x64, including the complete source validator.
- All seven downloaded installers/CLI archives match the release's SHA256SUMS.
- Both macOS bundles passed deep/strict ad-hoc signature checks and report 0.3.2; the Intel executable is x86_64 and the Apple Silicon executable is arm64.
- Both downloaded macOS CLIs passed help, text/JSON lint, exit codes 0/1/2 and isolated MCP smoke. Intel CLI execution used Rosetta on Apple Silicon, not a physical Intel Mac.
- The downloaded Linux CLI passed help, JSON version/schema and exit codes 0/1/2 in an isolated Ubuntu 22.04.5 x64 container with glibc 2.35, no network and read-only fixtures.
- Release-pinned Action entrypoints passed installation/checksum/extraction, a synthetic Git repository, annotations, summary and exit-code checks both against the authenticated draft and through the final public GitHub download URLs.
- The app copied from the Apple Silicon DMG restored the workspace, rendered the large synthetic document, accepted an additional Review comment, saved it explicitly and returned to Preview without a blank view. The test app was then closed.
- The app copied from the Intel DMG also restored the workspace and passed the same large-document Review interaction via Rosetta: typing, a fourth synthetic comment, explicit Save and return to Preview without a blank view. The test app was then closed. This was not a physical Intel Mac test.
- Windows desktop/MCP and a physical Intel Mac remain external clean-machine smoke tests; they are not claimed as validated by the local tests above.
Full change: PR #69. No Dock, terminal launcher, or existing installation is changed automatically by downloading this release.
Construct v0.3.1
Construct v0.3.1 makes the local knowledge service on-demand and resource-bounded, keeping agent access responsive without leaving an always-on indexer behind.
Highlights
- The local knowledge service now starts on desktop or MCP demand, stops after five idle minutes, and restarts transparently.
- MCP tool discovery no longer waits for indexing; accessed Locations reconcile on request.
- Indexed work is bounded to one active tool call plus at most 32 queued calls.
- Skipped reconciliations reuse the persisted index without a recursive source scan.
- Shutdown and restart races are covered on both Unix and Windows.
Downloads
- macOS Apple Silicon:
Construct_0.3.1_aarch64.dmg - macOS Intel:
Construct_0.3.1_x64.dmg - Windows x64:
Construct_0.3.1_x64-setup.exe - Standalone CLI archives are available for macOS Apple Silicon, macOS Intel, Windows x64, and Linux x64.
Verify downloaded files against SHA256SUMS.
Preview notice
Construct installers and binaries are currently unsigned. This release is therefore published as a pre-release. macOS and Windows may show operating-system security warnings during installation or first launch.
Changes
- On-demand, resource-bounded knowledge service: #64
- Release preparation: #65
- Full changelog: v0.3.0...v0.3.1
Construct v0.3.0
Construct v0.3.0 adds at-a-glance Git freshness to every repository in Locations, so teams can see when local work and the tracked remote have drifted before they start editing.
Highlights
- Compact Git status indicators for clean, dirty, ahead, behind, diverged, and warning states.
- Read-only remote checks that never fetch, pull, push, or modify repository state.
- Stable background refreshes without indicator flicker.
- A fixed trailing action slot so the repository status and three-dot menu no longer shift on hover.
Downloads
- macOS Apple Silicon:
Construct_0.3.0_aarch64.dmg - macOS Intel:
Construct_0.3.0_x64.dmg - Windows x64:
Construct_0.3.0_x64-setup.exe - CLI: standalone archives are available for macOS Apple Silicon, macOS Intel, Windows x64, and Linux x64.
Verify downloaded files with SHA256SUMS when appropriate.
Preview notice
This is a public pre-release. The macOS and Windows applications are currently unsigned, so the operating system may show a security warning during installation. Only install files downloaded from this release page.
Changes
Full changelog: v0.2.0...v0.3.0
Construct v0.2.0
Construct v0.2.0\n\nThis is a public pre-release for testing. The desktop installers are not yet signed with trusted developer certificates.\n\n## Desktop downloads\n\n- macOS Apple Silicon: Construct_0.2.0_aarch64.dmg\n- macOS Intel: Construct_0.2.0_x64.dmg\n- Windows x64: Construct_0.2.0_x64-setup.exe\n\n## Standalone CLI downloads\n\n- macOS Apple Silicon: construct_0.2.0_aarch64-apple-darwin.tar.gz\n- macOS Intel: construct_0.2.0_x86_64-apple-darwin.tar.gz\n- Windows x64: construct_0.2.0_x86_64-pc-windows-msvc.zip\n- Linux x64: construct_0.2.0_x86_64-unknown-linux-gnu.tar.gz\n\nDownload SHA256SUMS and verify the artifact before installation. On macOS or Linux, run: shasum -a 256 -c SHA256SUMS. On Windows, compare Get-FileHash output with the corresponding SHA256SUMS entry.\n\n## Highlights\n\n- Bundled JetBrains Mono for application chrome and Source Serif 4 for long-form Markdown reading.\n- Improved Source editor text, cursor, active-line, and selection contrast in light and dark themes.\n- Responsive OKF Graph that fills the available workspace height.\n- Warp support on macOS and Windows, plus a Windows system-default terminal fallback.\n- Fixed Ghostty opening on macOS through the supported native launch path.\n\n## Preview limitations\n\n- macOS builds use ad-hoc signing and are not notarized. Gatekeeper may require manual confirmation before opening.\n- The Windows installer is unsigned. Microsoft Defender SmartScreen may display a warning.\n- Linux ships the standalone CLI only.\n- Automatic updates remain disabled until signed release identity and rollback behavior are established.\n\nFull changelog: v0.1.9...v0.2.0
Construct v0.1.9
Construct v0.1.9
Construct v0.1.9 aligns the public documentation and release checks with the desktop path-opening and nine-tool MCP surface shipped in the current preview line.
Highlights
- Documents
construct .andconstruct <file.md>for opening Locations and Markdown files from the terminal. - Documents deterministic MCP document enumeration through
construct_list_documents. - Makes the MCP smoke test start an isolated local service and cover all nine tools with cursor pagination.
- Keeps the frontend, Rust, Tauri, lockfile, and release metadata on version 0.1.9.
Downloads
- macOS Apple Silicon desktop:
Construct_0.1.9_aarch64.dmg - macOS Intel desktop:
Construct_0.1.9_x64.dmg - Windows x64 desktop:
Construct_0.1.9_x64-setup.exe - Standalone CLI archives are provided for macOS Apple Silicon, macOS Intel, Windows x64, and Linux x64.
- Verify downloads using
SHA256SUMS.
Preview trust notice
This is a preview release. The macOS applications are ad-hoc signed and are not notarized. The Windows installer is unsigned. Operating systems may display security warnings. These artifacts should not be described as trusted stable distribution.
Verification
The release workflow validated the source, built every target, smoke-tested the Linux CLI, and generated SHA256SUMS. The downloaded Apple Silicon artifacts were additionally checksum-verified; the CLI passed text and JSON OKF lint plus the nine-tool MCP smoke; and the DMG image and embedded application verified successfully.
Full changelog: v0.1.8...v0.1.9
Construct v0.1.8
Construct v0.1.8 preview
This is an unsigned public preview. It is not yet a trusted stable release.
Desktop downloads
- macOS Apple Silicon:
Construct_0.1.8_aarch64.dmg - macOS Intel:
Construct_0.1.8_x64.dmg - Windows x64:
Construct_0.1.8_x64-setup.exe
The macOS bundles are ad-hoc signed and are not notarized. The Windows installer is unsigned. macOS Intel and Windows still await clean-machine external smoke testing; do not treat these artifacts as trusted production installers.
Standalone CLI
- macOS Apple Silicon:
construct_0.1.8_aarch64-apple-darwin.tar.gz - macOS Intel:
construct_0.1.8_x86_64-apple-darwin.tar.gz - Windows x64:
construct_0.1.8_x86_64-pc-windows-msvc.zip - Linux x64:
construct_0.1.8_x86_64-unknown-linux-gnu.tar.gz
Verify downloads against SHA256SUMS before installation. On macOS or Linux:
shasum -a 256 -c SHA256SUMSWhat changed
- Added deterministic MCP document enumeration with exact filters and cursor pagination (#44).
- Preserved the reading position when switching between Markdown modes (#45).
- Added terminal path opening (
construct .andconstruct file.md) and refined Explore facets, including frequency ordering (#46). - Prepared the v0.1.8 release candidate (#47).
The Apple Silicon DMG and CLI were checksum-verified and smoke-tested from the draft artifacts, including real text/JSON OKF lint, MCP startup, document enumeration, and the release-pinned action path. Signing, notarization, and clean-machine verification remain tracked in #19.
Full changelog: v0.1.7...v0.1.8
Construct 0.1.7 preview
Construct 0.1.7 preview
This preview makes the workspace sidebar adapt to the way you work instead of forcing fixed panel sizes.
Highlights
- Locations, Files, and History can be resized independently, and their proportions are remembered.
- Collapsing a panel now releases its space immediately so the remaining panels move up and expand naturally.
- Each panel scrolls independently; the global sidebar controls remain fixed while long Location lists move underneath them.
- Agent access and theme controls are now global workspace actions instead of being tied to the selected Location.
- Connecting agents supports an explicit access scope: the current Location, selected Locations, or all registered Locations. Construct never broadens access silently.
Downloads
- Windows desktop: download
Construct_0.1.7_x64-setup.exe. - macOS Apple Silicon: download
Construct_0.1.7_aarch64.dmg. - macOS Intel: download
Construct_0.1.7_x64.dmg. - Standalone CLI: use the
construct_0.1.7_*archive matching your platform. The Windows ZIP is the CLI, not the desktop installer. - Integrity:
SHA256SUMScontains the checksum for every installer and CLI archive.
GitHub's automatically generated source ZIP and tarball are source code, not application downloads.
Preview limitations
These builds are intentionally published as an unsigned preview:
- macOS uses ad-hoc signing and may show Gatekeeper warnings.
- Windows is unsigned and may show a Microsoft Defender SmartScreen warning.
Included work: #41. Full details are available in the changelog.
Construct v0.1.6
Construct 0.1.6 preview
This preview improves review workflows, terminal handoff, and the Windows desktop experience.
Highlights
- Review comments now stay anchored to their document passages. Highlights and comments navigate to one another, and changed or ambiguous passages are shown as detached instead of silently pointing at the wrong text.
- Switching between Preview, Edit, Review, Source, and Diff preserves the reading position and transfers the visible semantic passage between modes.
- Registered Locations and document folders can be opened in a supported external terminal, with the selected terminal remembered.
- The Windows desktop app no longer opens a companion console window. CLI commands keep their normal console behavior.
Downloads
- Windows desktop: download the file ending in
_x64-setup.exe. - macOS Apple Silicon: download the
aarch64DMG. - macOS Intel: download the
x64DMG. - Standalone CLI: use the archive matching your platform. The Windows
x86_64-pc-windows-msvc.zipis the CLI, not the desktop installer. SHA256SUMScontains the checksum for every installer and CLI archive.
GitHub's automatically generated source .zip and .tar.gz files are source code, not application downloads.
Preview limitations
These builds are intentionally published as an unsigned preview:
- macOS uses ad-hoc signing and may show Gatekeeper warnings.
- Windows is unsigned and may show a Microsoft Defender SmartScreen warning.
- The Windows build passed compilation and CI validation, but clean-machine desktop, index, and MCP smoke testing remains an external verification step.
Included work
- External terminal handoff: #34
- Windows desktop console fix: #36
- Anchored review navigation and cross-mode position continuity: #39
Full details are available in the changelog.
Construct v0.1.5
Download the installer for the desktop application or the standalone
construct CLI archive for your platform. Verify CLI downloads with
SHA256SUMS before installation.
What's Changed
- fix(release): normalize checksum line endings by @lfnovo in #29
- feat(okf): ship Linux CLI and GitHub Action by @lfnovo in #33
Full Changelog: v0.1.4...v0.1.5
Construct v0.1.4
Construct v0.1.4 — unsigned preview
This preview adds privacy-preserving local diagnostics for troubleshooting
knowledge search and fixes fallback behavior so a valid empty full-text result
remains empty.
Windows installation
Download Construct_0.1.4_x64-setup.exe below. Do not download the source
archives or the standalone CLI ZIP when you want the desktop application.
This preview is not yet code-signed. Windows SmartScreen may show an
Unknown publisher warning. Verify the download against SHA256SUMS before
running it.
Testing search diagnostics
After installing:
-
open the affected Location and wait for indexing to finish;
-
reproduce the empty search once;
-
close Construct;
-
open the log folder from PowerShell:
explorer "$env:APPDATA\com.luisnovo.construct\logs" -
send
construct.logandknowledge-service.logto the maintainer.
The logs are local, bounded, and omit document contents, filenames, repository
paths, frontmatter values, and search text.
Downloads
- macOS desktop: choose the
aarch64.dmgbuild for Apple Silicon orx64.dmg
for Intel. - Windows desktop: choose
Construct_0.1.4_x64-setup.exe. - Standalone CLI: choose the archive ending in your platform target.
- Integrity: use
SHA256SUMSto verify every installer and CLI archive.
Known limitation: the desktop installers are unsigned and not notarized in
this preview.