chore: cleanup markdown formatting and add puppeteer helpers

- Format markdown files to follow consistent style
- Add puppeteer helper scripts for testing Dioxus applications
- Update .gitignore to exclude *.local/ directories
- Document GitHub issue cleanup recommendations

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: sanity

.gitignore

@@ -3,6 +3,7 @@ aider_stdlib_map.md
 # Local tools and notes
 .local-tools/
 *.local.md
+*.local/
 
 # Release artifacts (downloaded binaries)
 release-artifacts/

LICENSE.md

@@ -1,10 +1,10 @@
 # How Freenet Licensing Works
 
 While `freenet-core` is licensed under the GNU Affero General Public
-License (AGPL), this does *not* mean that all software built on Freenet
+License (AGPL), this does _not_ mean that all software built on Freenet
 must also be AGPL-licensed.
 
-Applications that *use* Freenet—such as apps published to the network or
+Applications that _use_ Freenet—such as apps published to the network or
 clients that connect to it—are typically built against `freenet-stdlib`,
 which is licensed under the more permissive LGPL. This means your app can
 be licensed however you choose, including under a permissive or proprietary
@@ -236,23 +236,23 @@ produce it from the Program, in the form of source code under the
 terms of section 4, provided that you also meet all of these
 conditions:
 
--   a) The work must carry prominent notices stating that you modified
-    it, and giving a relevant date.
--   b) The work must carry prominent notices stating that it is
-    released under this License and any conditions added under
-    section 7. This requirement modifies the requirement in section 4
-    to "keep intact all notices".
--   c) You must license the entire work, as a whole, under this
-    License to anyone who comes into possession of a copy. This
-    License will therefore apply, along with any applicable section 7
-    additional terms, to the whole of the work, and all its parts,
-    regardless of how they are packaged. This License gives no
-    permission to license the work in any other way, but it does not
-    invalidate such permission if you have separately received it.
--   d) If the work has interactive user interfaces, each must display
-    Appropriate Legal Notices; however, if the Program has interactive
-    interfaces that do not display Appropriate Legal Notices, your
-    work need not make them do so.
+- a) The work must carry prominent notices stating that you modified
+  it, and giving a relevant date.
+- b) The work must carry prominent notices stating that it is
+  released under this License and any conditions added under
+  section 7. This requirement modifies the requirement in section 4
+  to "keep intact all notices".
+- c) You must license the entire work, as a whole, under this
+  License to anyone who comes into possession of a copy. This
+  License will therefore apply, along with any applicable section 7
+  additional terms, to the whole of the work, and all its parts,
+  regardless of how they are packaged. This License gives no
+  permission to license the work in any other way, but it does not
+  invalidate such permission if you have separately received it.
+- d) If the work has interactive user interfaces, each must display
+  Appropriate Legal Notices; however, if the Program has interactive
+  interfaces that do not display Appropriate Legal Notices, your
+  work need not make them do so.
 
 A compilation of a covered work with other separate and independent
 works, which are not by their nature extensions of the covered work,
@@ -271,42 +271,42 @@ sections 4 and 5, provided that you also convey the machine-readable
 Corresponding Source under the terms of this License, in one of these
 ways:
 
--   a) Convey the object code in, or embodied in, a physical product
-    (including a physical distribution medium), accompanied by the
-    Corresponding Source fixed on a durable physical medium
-    customarily used for software interchange.
--   b) Convey the object code in, or embodied in, a physical product
-    (including a physical distribution medium), accompanied by a
-    written offer, valid for at least three years and valid for as
-    long as you offer spare parts or customer support for that product
-    model, to give anyone who possesses the object code either (1) a
-    copy of the Corresponding Source for all the software in the
-    product that is covered by this License, on a durable physical
-    medium customarily used for software interchange, for a price no
-    more than your reasonable cost of physically performing this
-    conveying of source, or (2) access to copy the Corresponding
-    Source from a network server at no charge.
--   c) Convey individual copies of the object code with a copy of the
-    written offer to provide the Corresponding Source. This
-    alternative is allowed only occasionally and noncommercially, and
-    only if you received the object code with such an offer, in accord
-    with subsection 6b.
--   d) Convey the object code by offering access from a designated
-    place (gratis or for a charge), and offer equivalent access to the
-    Corresponding Source in the same way through the same place at no
-    further charge. You need not require recipients to copy the
-    Corresponding Source along with the object code. If the place to
-    copy the object code is a network server, the Corresponding Source
-    may be on a different server (operated by you or a third party)
-    that supports equivalent copying facilities, provided you maintain
-    clear directions next to the object code saying where to find the
-    Corresponding Source. Regardless of what server hosts the
-    Corresponding Source, you remain obligated to ensure that it is
-    available for as long as needed to satisfy these requirements.
--   e) Convey the object code using peer-to-peer transmission,
-    provided you inform other peers where the object code and
-    Corresponding Source of the work are being offered to the general
-    public at no charge under subsection 6d.
+- a) Convey the object code in, or embodied in, a physical product
+  (including a physical distribution medium), accompanied by the
+  Corresponding Source fixed on a durable physical medium
+  customarily used for software interchange.
+- b) Convey the object code in, or embodied in, a physical product
+  (including a physical distribution medium), accompanied by a
+  written offer, valid for at least three years and valid for as
+  long as you offer spare parts or customer support for that product
+  model, to give anyone who possesses the object code either (1) a
+  copy of the Corresponding Source for all the software in the
+  product that is covered by this License, on a durable physical
+  medium customarily used for software interchange, for a price no
+  more than your reasonable cost of physically performing this
+  conveying of source, or (2) access to copy the Corresponding
+  Source from a network server at no charge.
+- c) Convey individual copies of the object code with a copy of the
+  written offer to provide the Corresponding Source. This
+  alternative is allowed only occasionally and noncommercially, and
+  only if you received the object code with such an offer, in accord
+  with subsection 6b.
+- d) Convey the object code by offering access from a designated
+  place (gratis or for a charge), and offer equivalent access to the
+  Corresponding Source in the same way through the same place at no
+  further charge. You need not require recipients to copy the
+  Corresponding Source along with the object code. If the place to
+  copy the object code is a network server, the Corresponding Source
+  may be on a different server (operated by you or a third party)
+  that supports equivalent copying facilities, provided you maintain
+  clear directions next to the object code saying where to find the
+  Corresponding Source. Regardless of what server hosts the
+  Corresponding Source, you remain obligated to ensure that it is
+  available for as long as needed to satisfy these requirements.
+- e) Convey the object code using peer-to-peer transmission,
+  provided you inform other peers where the object code and
+  Corresponding Source of the work are being offered to the general
+  public at no charge under subsection 6d.
 
 A separable portion of the object code, whose source code is excluded
 from the Corresponding Source as a System Library, need not be
@@ -382,23 +382,23 @@ Notwithstanding any other provision of this License, for material you
 add to a covered work, you may (if authorized by the copyright holders
 of that material) supplement the terms of this License with terms:
 
--   a) Disclaiming warranty or limiting liability differently from the
-    terms of sections 15 and 16 of this License; or
--   b) Requiring preservation of specified reasonable legal notices or
-    author attributions in that material or in the Appropriate Legal
-    Notices displayed by works containing it; or
--   c) Prohibiting misrepresentation of the origin of that material,
-    or requiring that modified versions of such material be marked in
-    reasonable ways as different from the original version; or
--   d) Limiting the use for publicity purposes of names of licensors
-    or authors of the material; or
--   e) Declining to grant rights under trademark law for use of some
-    trade names, trademarks, or service marks; or
--   f) Requiring indemnification of licensors and authors of that
-    material by anyone who conveys the material (or modified versions
-    of it) with contractual assumptions of liability to the recipient,
-    for any liability that these contractual assumptions directly
-    impose on those licensors and authors.
+- a) Disclaiming warranty or limiting liability differently from the
+  terms of sections 15 and 16 of this License; or
+- b) Requiring preservation of specified reasonable legal notices or
+  author attributions in that material or in the Appropriate Legal
+  Notices displayed by works containing it; or
+- c) Prohibiting misrepresentation of the origin of that material,
+  or requiring that modified versions of such material be marked in
+  reasonable ways as different from the original version; or
+- d) Limiting the use for publicity purposes of names of licensors
+  or authors of the material; or
+- e) Declining to grant rights under trademark law for use of some
+  trade names, trademarks, or service marks; or
+- f) Requiring indemnification of licensors and authors of that
+  material by anyone who conveys the material (or modified versions
+  of it) with contractual assumptions of liability to the recipient,
+  for any liability that these contractual assumptions directly
+  impose on those licensors and authors.
 
 All other non-permissive additional terms are considered "further
 restrictions" within the meaning of section 10. If the Program as you

README.md

@@ -16,20 +16,20 @@
   </a>
 </div>
 
-This is the freenet-core repository. To learn more about Freenet please visit our website 
+This is the freenet-core repository. To learn more about Freenet please visit our website
 at [freenet.org](https://freenet.org/).
 
 # Decentralize Everything
 
-Freenet is the internet as it should be—fully decentralized, designed to put you back in control. Imagine a global shared 
-computer where you can communicate and collaborate freely, without reliance on big tech. Freenet lets you regain your 
+Freenet is the internet as it should be—fully decentralized, designed to put you back in control. Imagine a global shared
+computer where you can communicate and collaborate freely, without reliance on big tech. Freenet lets you regain your
 digital independence.
 
-Freenet is a peer-to-peer network that transforms users’ computers into a resilient, distributed platform on which anyone 
-can build decentralized services. Every peer contributes to a fault-tolerant collective, ensuring services are always 
+Freenet is a peer-to-peer network that transforms users’ computers into a resilient, distributed platform on which anyone
+can build decentralized services. Every peer contributes to a fault-tolerant collective, ensuring services are always
 available and robust.
 
-Today’s web is a series of siloed services, but every system built on Freenet is fully interoperable by default. Freenet 
+Today’s web is a series of siloed services, but every system built on Freenet is fully interoperable by default. Freenet
 apps can be built with popular web frameworks, accessed through any browser just like the web.
 
 ## Build Instructions

apps/freenet-email-app/README.md

@@ -37,7 +37,9 @@ local node, which simulates a node on the network.
   ```bash
   git submodule update --init --recursive
   ```
+
 ### Note about MacOS
+
 Email account creation currently does not work on MacOS
 
 ## Prepare the Freenet email contracts and delegates
@@ -59,6 +61,7 @@ This delegate is located inside the modules folder of freenet-core:
       - ...
 
 Add the target directory for the project. This should be an absolute file path to freenet-core/target.
+
 ```bash
 export CARGO_TARGET_DIR="... freenet-core/target"
 ```

apps/freenet-microblogging/README.md

@@ -31,23 +31,23 @@ Prepare the microblogging app web and posts contracts.
 The app is located inside the `apps/freenet-microblogging` folder:
 
 - `freenet-core/`
-    - `apps/`
-        - `freenet-microblogging/` <-- this folder contains the microblogging app
-            - `contracts/` <-- this folder contains the contract source code
-                - `posts/` <-- this folder contains the posts contract
-                    - `build/` <-- the generated folder that contains the compiled contract binary with version + wasm
-                      code
-                    - `src/` <-- this folder contains the source code of the contract
-                    - ...
-            - `web/` <-- this folder contains the web app source code, web app built with node and webpack
-                - `build/` <-- the generated folder that contains the compiled web app binary with version + wasm
-                  code
-                - `container/` <-- this folder contains the web contract container, a simple contract associated
-                  with the web app, as the state.
-                - `src/` <-- this folder contains the source code of the web app
-                - ...
-            - `Makefile` <-- this file contains the build instructions for building and running the web app, and
-              the local node.
+  - `apps/`
+    - `freenet-microblogging/` <-- this folder contains the microblogging app
+      - `contracts/` <-- this folder contains the contract source code
+        - `posts/` <-- this folder contains the posts contract
+          - `build/` <-- the generated folder that contains the compiled contract binary with version + wasm
+            code
+          - `src/` <-- this folder contains the source code of the contract
+          - ...
+      - `web/` <-- this folder contains the web app source code, web app built with node and webpack
+        - `build/` <-- the generated folder that contains the compiled web app binary with version + wasm
+          code
+        - `container/` <-- this folder contains the web contract container, a simple contract associated
+          with the web app, as the state.
+        - `src/` <-- this folder contains the source code of the web app
+        - ...
+      - `Makefile` <-- this file contains the build instructions for building and running the web app, and
+        the local node.
 
 To build the microblogging application, go to the `apps/freenet-microblogging` folder and run the following command:
 

apps/freenet-ping/README.md

@@ -85,23 +85,28 @@ This project includes two Makefiles to help you set up and run a local Freenet n
 - `run-ping.mk`: Builds and runs the ping application.
 
 ### Start Local Network
+
 1. Navigate to the `freenet-core/scripts` directory:
+
    ```bash
    cd freenet-core/scripts
    ```
 
 2. First, clean any previous setup and create necessary directories:
+
    ```bash
    make -f local-network.mk clean
    make -f local-network.mk setup N_GATEWAYS=1 N_NODES=2
    ```
 
 3. Start the gateway:
+
    ```bash
    make -f local-network.mk start-gateways N_GATEWAYS=1
    ```
 
 4. Start the nodes:
+
    ```bash
    make -f local-network.mk start-nodes N_NODES=2
    ```
@@ -112,6 +117,7 @@ This project includes two Makefiles to help you set up and run a local Freenet n
    ```
 
 The network will be configured with:
+
 - 1 Gateway on port 3101
 - Node 1: WebSocket port 3001, Network port 3102
 - Node 2: WebSocket port 3002, Network port 3103
@@ -135,26 +141,30 @@ make -f local-network.mk clean
 ## Build and Run Ping
 
 1. Navigate to the `freenet-core/apps/freenet-ping` directory:
+
    ```bash
    cd freenet-core/apps/freenet-ping
    ```
 
 1. View available options:
+
    ```bash
    make -f run-ping.mk help
    ```
 
-2. Build the contract and application:
+1. Build the contract and application:
+
    ```bash
    make -f run-ping.mk build
    ```
 
-3. Run ping towards node 1:
+1. Run ping towards node 1:
    ```bash
    make -f run-ping.mk run WS_PORT=3001
    ```
 
 You will see something like this:
+
 ```bash
 2024-05-14T15:33:20.685412Z  INFO freenet_ping: 154: put ping contract successfully! key=Cuj4LbFao6vzZ5VtvZAKZ64Y99qNh7MpTUdaCcEkU4oR
 2024-05-14T15:33:20.729883Z  INFO freenet_ping: 146: Hello, ubiquitous-letters!
@@ -163,6 +173,7 @@ You will see something like this:
 ```
 
 You can customize the ping behavior with these parameters:
+
 ```bash
 make -f run-ping.mk run WS_PORT=3001 FREQUENCY=2000 TTL=7200
 ```
@@ -182,4 +193,4 @@ make -f run-ping.mk clean
 
 ## Feedback
 
-If you encounter any issues please let us know in our [Matrix](https://matrix.to/#/#freenet-locutus:matrix.org) channel or by submitting a [Github Issue](https://github.com/freenet/freenet-core/issues).
+If you encounter any issues please let us know in our [Matrix](https://matrix.to/#/#freenet-locutus:matrix.org) channel or by submitting a [Github Issue](https://github.com/freenet/freenet-core/issues).