v7.1.0-alpha

Acorn V7.1.0-alpha

✨ What's New ✨

• Added a user preference to switch between two methods of navigating the map view using your keyboard:
  1. Using a modal
     • This method will present you with a list of parent/child outcomes for you to choose from when navigating up or down.
  2. Using coordinates of other outcomes
     • This method will decide which outcome to navigate to based on the currently highlighted outcome's location relative to its children/parents. Currently, this is decided by taking the left-most outcome, but this could be expanded upon/improved in future updates.

For MacOS

if you are using an Intel based Mac, download the darwin-x64.zip file.
if you are using an Apple Silicon (M-series) based Mac, download the darwin-arm64.zip file.

v7.0.1-alpha

Acorn Version v7.0.1-alpha

This minor release does a lot behind the scenes to make the frontend part of the app more robust for users when encountering errors, and to make the code more maintainable in the future.

✨ What's New ✨

• Installed Jest as a unit testing framework
• Installed Zod for a run-time type checking and schema validation
• Replaced a large number of existing data types with Zod schemas
  • This will allow us to do things like make sure the user inputs correct/valid information when asked to do so.
• Added some more Github Action workflow steps to have a more robust CI

None of these will be visible from within the app, but they give us a much greater level of confidence that future changes do not break the existing functionality of the app. As time goes on, more tests and refactors will be squeezed in to future updates to improve the experience even further.

🐞 Bug Fixes

• Fixed a bug causing acorn to crash when clicking on the elipsis (...) under each project (Github Issue #318)
• Fixed a bug causing migration to fail when not all projects are synced (Github Issue #310)
• Fixed a bug where users always appear online when trying to add an assignee to an outcome (Github Issue #317)

For MacOS

if you are using an Intel based Mac, download the darwin-x64.zip file.
if you are using an Apple Silicon (M-series) based Mac, download the darwin-arm64.zip file.

v7.0.0-alpha

• added a Factory Reset file menu option, to reset the entire state, including your keys, of your current version
• added migration error handling to smooth the version migration process
• added the ability to override a migrated project so that it can be used again, if it was migrated by accident or if something went wrong

Runs on holochain version 0.2.1

v6.1.0-alpha

Keyboard navigation is back and better than ever.

For Apple Silicon Macs, download the Acorn.6.1.0-alpha.darwin-arm64.zip file.

For Intel Macs, download the Acorn.6.1.0-alpha.darwin-x64.zip file.

v6.0.1-alpha

🐞 Bug Fixes

• Fixed a bug which would result in the version being out of date
• Fixed a bug allowing users to create a cycle in the graph
• Fixed a bug allowing users to create the same connection more than once

✨ New Features

• A syncing indicator 🔄 will appear at the bottom of the page when your Acorn client is actively syncing with a peer.

v5.0.2-alpha

🐞 Bug Fixes

• Fixed bug where quitting Acorn would leave a dangling sub-process, rendering the app unable to be re-opened.

Note: You may find that Acorn still will not start after downloading this update. This is because the orphaned child process is still alive. To kill it, follow these steps:

• Open Activity Monitor / Task Manager
• Search for holochain-runner (holo should be sufficient to find it)
• Quit/End task
• Start Acorn up again
• Profit 📈 💰

Known issues: this version is prompting users to update to the same version as they are already on. You can and should safely ignore this.

v5.0.1-alpha

If you tried to use the update feature of Acorn to migrate from Acorn version 3.x.x or Acorn version 4.x.x, and found your projects and profile empty after updating, you can download this version and you will be able to complete the version update process correctly.

-> Known Issues
-> There is still an issue in v5.0.1-alpha where the app will not start after it has been closed once, and you try to re-open it. We are working on a fix. We are working to diagnose and fix.

v5.0.0-alpha

🌱 🍏 What's new in Acorn's Spring release:

Note: If you have already installed Acorn 3.0.0-alpha or Acorn 4.0.0-alpha, you will automatically get the update notification within the app and are able to update automatically (MacOS) or semi-automatically (Linux and Windows). All your data will be migrated on your behalf. However, if you are on any versions prior to 3.0.0-alpha you would have to manually migrate your projects and install the new version.

** Please, let us know in the Issues or Discussions areas of GitHub about your thoughts on the new changes. Love them? Hate them? Chime in. **

-> Known Issues
-> There is an issue in v5.0.0-alpha where the app will not start after it has been closed once, and you try to re-open it. We are working on a fix.

✨ New Features!

• Multi-parent functionality:

  • An outcome can be a child of any number of outcomes. This functionality comes at the cost of some other features needing to be disabled until further notice, which will be explained further down.
  • Drag from the top of an existing outcome to either add a new parent outcome or to append an existing outcome to its list of parents.

• New layout options:

  • The first of a potentially much larger number of project-wide options is a new way to display your project.

  • Select from two layering algorithms (which assign outcomes to 'layers' in the map view): Minimum Height and Constrained Width.

    • Minimum Height: Assign outcomes to layers such that the minimum number of layers is necessary to represent the entire project. The side effect of this is that your project may get 'wider', but the height of the project may decrease.
    • Constrained Width: Try to compress the width of the project down. This makes the project look 'taller', but outcomes are closer together.

  • Certain configurations of connections may result in the layering algorithm having no effect on the appearance of the project. This is not a bug, and usually happens when the project is small and there are no changes the algorithm can make to reduce the width/height.

  • This option is project-wide, meaning it will persist, and other members of your project will be exposed to your selection, which will affect their view.

  • New options can be added in the future. This is just a pilot to see if users like this kind of functionality.

---

⚡️ Improvements

• Map view: The map view now uses a Directed Acyclic Graph structure to represent outcomes and their connections. This was necessary to allow for the multiple parent functionality.
• Lower zoom thresholds: The map view now has a lower zoom threshold for displaying placeholder cards for outcomes.
• Github links are more strict: Using the power of regular expressions, the Github link in an outcome must be a link to either an issue or pull request.

---

🐞 Bug Fixes

• Users will no longer be prompted to upgrade their Acorn client to a version which is lower than the version they currently have installed.
• Github links no longer render a link if the link is not a valid url or a github issue/pull request link.

---

🛑 Disabled Features

Unfortunately, these features were impacted by the multiple parent functionality, and have been disabled until further notice:

• Collapse outcomes
  • The nature of the directed acyclic graph structure makes this functionality significantly more complex, and the only way to implement it is to have some kind of opinion on how it should be done. We may add this feature back in at some point, but it's going to take some more thinking on our end to figure out the best way to do it.
• Keyboard navigation
  • Having multiple parents introduces some ambiguity as to where the camera should pan to when using the keyboard. For example, if the up arrow is pressed, which parent should the camera pan to? The concept of siblings also becomes a bit more complex, as now more than one outcome can contribute to a particular outcome's number of siblings. Aside from that, these siblings may not always be next to each other, which can be jarring when trying to navigate left and right.

Note for MacOS: If you use an Intel Mac (pre-M1/M2) download the file ending in darwin-x64.zip. If you use an M1/M2 Mac, download the file ending in darwin-arm64.zip.

v4.0.0-alpha

Note: If you have already installed Acorn 3.0.0-alpha, you will automatically get the update notification within the app and are able to update automatically (MacOS) or semi-automatically (Linux and Windows). All your data will be migrated on your behalf. However, if you are on any versions prior to 3.0.0-alpha you would have to manually migrate your projects and install the new version.

🎄❄️✨ What’s new on Acorn’s Holiday Release:

Backend

• Acorn now runs on Holochain Beta release candidate! Read the Holochain Beta release announcement.

New Features

• You can now create new Child Outcomes for any non-Small Outcome via Children List tab on Expanded View.
• Existing tags are now editable (feature request #171)
• You can have custom viewing options on Map View to hide all Achieved Outcomes or/and all Small Scope Outcomes from sight (see the eye icon on bottom right of Map View).

Fixes & Improvements

• Fixed issue with the multi-select function by shift-click dragging on the canvas
• Fixed the Priority View and Table View scrollable windows issue

Note for MacOS: If you use an Intel Mac (pre-M1/M2) download the file ending in darwin-x64.zip. If you use an M1/M2 Mac, download the file ending in darwin-arm64.zip.

Known Issues

Linux: The Linux application is currently failing to launch for those running Ubuntu 20 version of Linux. Broader platform support may come in the future, but at this time our recommendation is to update to the new LTS version of Ubuntu: Ubuntu 22.

v3.0.0-alpha

⚠️ This release is a breaking one. You will need to export your projects from the previous version of Acorn and import them into this one.

New stuff

• After you migrate to this release, Acorn will have auto update flow for MacOS and semi-auto update flow for Linux and Windows when future versions of the app become available.
• You can now collapse or expand Children of any Parent Outcome on Map View. Right click on the Outcome Card you want to see the option.
• You can now copy Statement text of any Outcome on Map View using the new right click menu. Right click on the Outcome Card you want to see the option.

Improvements and fixes

• Zooming consistency improvements on Map View
• Fixed the issue with Claimed Ghost Members not automatically turning into normal avatars
• Some code cleanups

MacOS Note: For Intel MacOS download the darwin-x64.zip file. For M1/M2 MacOS download the darwin-arm64.zip file.