Init chat code import

Author: theokeist

.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

.env.example

@@ -0,0 +1,14 @@
+APP_ENV=local
+APP_DEBUG=true
+APP_KEY=change-me
+
+SESSION_COOKIE=pipeflow_session
+SESSION_SECURE=false
+SESSION_SAME_SITE=Lax
+
+DB_DRIVER=sqlite
+DB_DATABASE=storage/database.sqlite
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_USERNAME=
+DB_PASSWORD=

.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.3'
+          extensions: pdo, json, mbstring
+      - name: Install dependencies
+        run: composer install --no-interaction --prefer-dist
+      - name: Lint
+        run: find src app bootstrap public routes -name '*.php' -print0 | xargs -0 -n 1 php -l
+      - name: PHPUnit
+        run: composer test

.gitignore

@@ -0,0 +1,9 @@
+/vendor/
+/.env
+/storage/
+/.phpunit.cache/
+/coverage/
+
+# OS
+.DS_Store
+Thumbs.db

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PipeFlow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,85 @@
+# PipeFlow
+
+PipeFlow is a pragmatic PHP **8.5+** framework that leans hard into **functional composition** (pipeline style) while still giving you familiar MVC ergonomics (controllers, models, views, migrations) + a CLI scaffold.
+
+## Quickstart
+
+```bash
+composer install
+cp .env.example .env
+php pipeflow serve
+```
+
+Open: `http://127.0.0.1:8000`
+
+## Documentation
+
+- Main docs: `docs/README.md`
+- Architecture overview: `docs/ARCHITECTURE.md`
+- Per-file reference: `docs/reference/`
+- Codex / AI contributor notes: `docs/CODEX.md`
+
+## Routing
+
+Routes live in `routes/web.php`:
+
+```php
+$router = app(\PipeFlow\Router\Router::class);
+$router->get('/', [\App\Controllers\HomeController::class, 'index'], 'home');
+```
+
+### Conn + Plugs (Phoenix-inspired)
+
+PipeFlow now supports Phoenix-ish request flow using a `Conn` object and a plug pipeline.
+
+- `PipeFlow\Http\Conn` carries Request, Response, session, assigns, etc.
+- Plugs implement `PipeFlow\Plug\Contracts\PlugInterface` and are composed via `PlugStack`.
+- Built-in plugs: `SessionPlug`, `CsrfPlug` (enabled by default in the Kernel).
+
+Write a route handler that receives a Conn:
+
+```php
+use PipeFlow\Http\Conn;
+
+$router->get('/hello', function (Conn $conn) {
+    return $conn->assign('name', 'world')->render('hello');
+});
+```
+
+## Views
+
+`view('welcome', ['title' => 'PipeFlow'])` renders `resources/views/welcome.php`.
+
+## Models
+
+Create a model:
+
+```bash
+php pipeflow make:model Post --migration
+```
+
+Base model lives at `PipeFlow\Database\Model`.
+
+## Migrations
+
+```bash
+php pipeflow migrate
+php pipeflow migrate:rollback --steps=1
+```
+
+Migrations live in `database/migrations`.
+
+## Functional pipeline
+
+Use the global `pipe()` helper:
+
+```php
+$result = pipe('hello',
+  fn($s) => strtoupper($s),
+  fn($s) => $s . ' WORLD'
+);
+```
+
+## License
+
+MIT

app/Controllers/HomeController.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Controllers;
+
+use PipeFlow\Http\Request;
+use PipeFlow\Http\Response;
+
+final class HomeController
+{
+    public function index(Request $request): Response
+    {
+        return view('welcome', [
+            'title' => 'PipeFlow',
+            'message' => 'Framework skeleton is live. Try: php pipeflow route:list',
+        ]);
+    }
+}

app/Web/Controllers/HomeController.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Web\Controllers;
+
+use PipeFlow\Http\Conn;
+
+/**
+ * Example controller using Conn-style handlers (Phoenix-ish).
+ */
+final class HomeController
+{
+    public function index(Conn $conn): Conn
+    {
+        return $conn->render('welcome', [
+            'title' => 'PipeFlow',
+            'message' => 'Phoenix-ish router pipelines + flash + session are wired. Try: php pipeflow route:list',
+        ]);
+    }
+}

app/Web/Endpoint.php

@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Web;
+
+use PipeFlow\Foundation\Application;
+use PipeFlow\Router\Router;
+
+/**
+ * Endpoint (Phoenix analogue)
+ *
+ * Central place to wire the HTTP entrypoint:
+ *  - global plugs (run for every request)
+ *  - router definition (pipelines/scopes/routes)
+ *
+ * In Phoenix, Endpoint also handles static assets, code reloading, sockets, etc.
+ * PipeFlow keeps this lightweight and adapter-friendly.
+ */
+final class Endpoint
+{
+    /**
+     * Global plugs applied to every request (before the router / per-route pipelines).
+     *
+     * @return array<int, string|object|callable>
+     */
+    public function plugs(Application $app): array
+    {
+        // Keep this minimal. Put Session/CSRF into the "browser" pipeline in RouterDefinition.
+        return [];
+    }
+
+    /**
+     * Register pipelines, scopes and routes.
+     */
+    public function boot(Application $app): void
+    {
+        /** @var Router $router */
+        $router = $app->container()->get(Router::class);
+        RouterDefinition::register($router, $app);
+    }
+}