Initial Tools including README parser

.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{nix,yml,yaml}]
+indent_size = 2

.gitignore

@@ -0,0 +1,15 @@
+# ignore all dotfiles and dotdirs by default, with exceptions below
+.*
+!.gitignore
+!.editorconfig
+
+builders/
+node_modules/
+tmp/
+vendor/
+
+*.log
+*.tmp
+
+# default output file for 'nix build'
+result

README.md

@@ -1,10 +1,25 @@
 # FAIR Forge
 
-Immediate goals:
-1. convert legacy WordPress packages to FAIR-formatted packages & package-meta; 
+## Requirements
+
+* Nix, with flakes support.  I _highly_ recommend the [Determinate Systems installer](https://docs.determinate.systems/)
+* Recommended: `direnv` (should be available on apt/brew/dnf/pacman/etc)
+
+**Note:** Nix is required to develop fair-forge itself, but will not be required to run builders -- however, those will likely require a container runtime such as Docker.
+
+## Quick Start
+
+```
+echo "use flake" > .envrc && direnv allow   # if using direnv
+nix develop
+```
+
+## Immediate goals
+
+1. convert legacy WordPress packages to FAIR-formatted packages & package-meta;
 2. run automated code validation and perform external verifications on the code & attestations in the package meta.
 
-Important: This project will use the MIT license. Any GPL (or similar) code *must* be in a separate repository as a standalone service for use by aspirebuild, and not integrated with it.
+Important: This project will use the MIT license. Any GPL (or similar) code *must* be in a separate repository as a standalone service for use by FAIR Forge, and not integrated with it.
 
 ## Work In Progress
 
@@ -19,12 +34,12 @@ Some vague notes below.  Things will take a more defined shape as we build out t
 * Focus on attested reproducible builds
 * Tools have minimal privileges, limited to only stdin/stdout where feasible
 * Tools are selected, configured, and packaged together in a **builder**
-  * environments are as hermetic as possible (containers or nix) 
-  * attestations are created for each tool's run
-  * dispense capabilities to tools that need more than stdin/stdout
-  * continuously reconcile input state to output state
-  * All input and output state traces to a hash (file or parent dir hash)
-  * validate all claims/attestations (e.g. hashes) on completion
+    * environments are as hermetic as possible (containers or nix)
+    * attestations are created for each tool's run
+    * dispense capabilities to tools that need more than stdin/stdout
+    * continuously reconcile input state to output state
+    * All input and output state traces to a hash (file or parent dir hash)
+    * validate all claims/attestations (e.g. hashes) on completion
 
 ## Potential Tools (old, needs update)
 

composer.json

@@ -0,0 +1,38 @@
+{
+    "name": "fairpm/fair-forge",
+    "authors": [
+        {
+            "name": "Chuck Adams",
+            "email": "chaz@chaz.works"
+        }
+    ],
+    "require": {
+        "thecodingmachine/safe": "^3.3",
+        "ext-intl": "*",
+        "ext-mbstring": "*",
+        "symfony/var-dumper": "^7.3",
+        "ext-dom": "*",
+        "ext-libxml": "*",
+        "league/commonmark": "^2.7",
+        "ezyang/htmlpurifier": "^4.19",
+        "ext-ds": "*",
+        "league/uri-polyfill": "^7.6",
+        "league/uri-components": "^7.6"
+    },
+    "require-dev": {
+        "roave/security-advisories": "dev-latest",
+        "phpunit/phpunit": "^12.4",
+        "codeception/verify": "^3.3"
+    },
+    "autoload": {
+        "psr-4": {
+            "FAIR\\Forge\\": "src",
+            "FAIR\\Forge\\Tools\\WpPlugin\\": "tools/wp-plugin/src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\FAIR\\Forge\\Tools\\WpPlugin\\": "tools/wp-plugin/tests/"
+        }
+    }
+}