langflower 0.1.3 → 0.2.1

package/docs/public/extending.md

@@ -63,9 +63,27 @@ Use `defineReactiveNode` only when you need streaming / RxJS ports. Prefer
 
 ## After you change a pack
 
-Restart Langflower (or follow the product’s pack reload path when available)
-so the runtime picks up new node types. New nodes should appear in the node
-library for that project.
+No restart needed: open the **node library** sidebar, expand the **Custom**
+section, and press **Update**. Langflower recompiles the packs under
+`.langflower/nodes/` and hot-swaps the catalog — new or changed node types
+appear in the library for that project. Compilation errors are listed under the
+same section.
+
+Restart Langflower only when you added pack **dependencies** (run `npm install`
+inside the pack first).
+
+## After you upgrade Langflower
+
+Your packs are compiled against the SDK that ships **inside the installed
+Langflower**, not against the `@langflower/node-sdk` version written in the pack
+`package.json` (that entry is an editor hint). An upgrade therefore recompiles
+every pack on next use:
+
+- Compatible SDK change — nothing to do.
+- A pack using API that the new SDK removed or renamed fails to compile: the
+  errors are listed in the **Custom** palette section and in that pack's
+  `COMPILATION_ERRORS.md`. Only that pack is skipped; other packs keep working.
+  Fix the source and press **Update**.
 
 ## Deeper guides (monorepo)
 

package/docs/public/getting-started.md

@@ -30,7 +30,8 @@ on its own port. User manual:
 Windows and macOS zips are on
 [GitHub Releases](https://github.com/earthdmitriy/langflower/releases)
 (tags `launcher-v*`, not the npm `v*` tags). You still need Node.js and
-`npm install -g langflower`. On macOS, right-click the binary → Open.
+`npm install -g langflower`. On macOS, right-click **Langflower.app** →
+Open.
 
 Stop the process with Ctrl+C when you are done. There is no cloud account and
 no background daemon.

package/docs/public/how-it-works.md

@@ -42,5 +42,5 @@ See [Extending](extending.md) and [Configuration](configuration.md).
 
 ## Monorepo deep dives
 
-In the Langflower source tree (not shipped here): `docs/ARCHITECTURE.md`,
-`docs/EXECUTION_ARCHITECTURE.md`, and `docs/PRINCIPLES.md`.
+In the Langflower source tree (not shipped here): `docs/architecture/ARCHITECTURE.md`,
+`docs/architecture/EXECUTION_ARCHITECTURE.md`, and `docs/architecture/PRINCIPLES.md`.

package/docs/public/launcher.md

@@ -19,10 +19,11 @@ Unsigned Windows and macOS zips are on
 - `langflower-launcher-macos-arm64.zip`
 - `langflower-launcher-macos-x64.zip`
 
-Unpack and run `langflower-launcher.exe` (Windows) or
-`langflower-launcher` (macOS). Windows SmartScreen and macOS Gatekeeper
-will warn because the binary is unsigned. On macOS: right-click the
-file → **Open**.
+The macOS zip contains `Langflower.app` (so Finder does not open
+Terminal). Unpack and run `langflower-launcher.exe` (Windows) or
+`Langflower.app` (macOS). Windows SmartScreen and macOS Gatekeeper
+will warn because the files are unsigned. On macOS: right-click the
+**app** → **Open**.
 
 Linux has no published zip in v1.
 
@@ -96,14 +97,14 @@ already have current versions — that is not an install.
 
 ## If something goes wrong
 
-| What you see                     | What to try                                               |
-| -------------------------------- | --------------------------------------------------------- |
-| Start stays grey                 | Install Node and/or Langflower; choose a folder           |
-| “That folder could not be found” | Browse again; the path must exist                         |
-| “No free port is available”      | Stop other Langflower instances using 4010–4109           |
-| Gatekeeper / SmartScreen         | Unsigned zip — Open anyway as above                       |
-| Editor does not load             | Wait for Running; open Details; try Open ↗                |
-| Update offer every launch        | Skip is session-only; Update installs `langflower@latest` |
+| What you see                     | What to try                                                  |
+| -------------------------------- | ------------------------------------------------------------ |
+| Start stays grey                 | Install Node and/or Langflower; choose a folder              |
+| “That folder could not be found” | Browse again; the path must exist                            |
+| “No free port is available”      | Stop other Langflower instances using 4010–4109              |
+| Gatekeeper / SmartScreen         | Unsigned — right-click the `.exe` or `Langflower.app` → Open |
+| Editor does not load             | Wait for Running; open Details; try Open ↗                   |
+| Update offer every launch        | Skip is session-only; Update installs `langflower@latest`    |
 
 Need the terminal path instead? See
 [Getting started](getting-started.md). Once a project is running, use

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "langflower",
-	"version": "0.1.3",
+	"version": "0.2.1",
 	"description": "Visual LLM-chain builder",
 	"type": "module",
 	"bin": {