Phase 1: admin login page + secret-link token auth

- /admin login page (public, noindex): password form + signed-in panel that activates the in-page console. Verified in-browser: login -> panel -> the astroagent handle appears on other pages. - Secret-link login: visit /admin/<token> to sign in without a password. adminauth token() validates a bcrypt-hashed token, sets the session, 302s to /admin. nginx routes the token path to PHP. set-admin-token.php generates it. - Password login kept as a fallback. Verified: token link -> session -> console access; bad token -> /admin?e=1. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01DoFYZY9gkGPNDqZ7NuEa9a
2026-07-23 22:15:50 +00:00 · 2026-07-23 22:15:50 +00:00 · b967419717
commit b967419717
parent e57856173a
5 changed files with 467 additions and 0 deletions
--- a/api/cli/set-admin-token.php
+++ b/api/cli/set-admin-token.php
@ -0,0 +1,33 @@
+<?php
+/**
+ * Generate a secret-link login token for an admin. Run it yourself:
+ *
+ *   php api/cli/set-admin-token.php <username>
+ *
+ * Prints the token and the full login URL ONCE — it is not recoverable
+ * afterwards (only its hash is stored). Re-run to rotate.
+ */
+
+require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../config.php';
+
+$username = $argv[1] ?? '';
+if ($username === '') {
+    fwrite(STDERR, "usage: php api/cli/set-admin-token.php <username>\n");
+    exit(1);
+}
+
+$id = Db::getValue('SELECT admin_id FROM cja_admin WHERE username = ?', [$username]);
+if (!$id) {
+    fwrite(STDERR, "No admin '{$username}'. Create one first with set-admin-password.php\n");
+    exit(1);
+}
+
+// URL-safe, 43 chars of entropy.
+$token = rtrim(strtr(base64_encode(random_bytes(32)), '+/', '-_'), '=');
+Db::update('cja_admin', ['token_hash' => password_hash($token, PASSWORD_DEFAULT)], 'admin_id = ?', [$id]);
+
+$base = defined('SITE_URL') ? SITE_URL : 'https://carlosarias.co';
+echo "\n  Admin login link (save it — shown only once):\n\n";
+echo "  {$base}/admin/{$token}\n\n";
+echo "  Rotate any time by re-running this. The old link stops working.\n";
--- a/api/db/migrations/009_admin_token.sql
+++ b/api/db/migrations/009_admin_token.sql
@ -0,0 +1,8 @@
+-- Secret-link login for the admin console.
+--
+-- A hashed token so you can log in by visiting /admin/<token> instead of typing
+-- a password. Stored the same way as the password (bcrypt) — the plaintext
+-- lives only in your bookmark. Password login stays as a fallback.
+
+ALTER TABLE `cja_admin`
+  ADD COLUMN `token_hash` varchar(255) DEFAULT NULL AFTER `password_hash`;
--- a/api/public/controllers/adminauth.php
+++ b/api/public/controllers/adminauth.php
@ -74,6 +74,38 @@ class AdminAuth extends PublicController
        $this->json(['admin' => true, 'username' => $row['username']]);
    }

+    /**
+     * Secret-link login: GET /admin/<token> (nginx routes it here as
+     * ?t=<token>). Validates against the stored token hash, sets the admin
+     * session, and redirects to /admin. On failure, redirects with ?e=1.
+     *
+     * Note: the token appears in this request's path, so it can land in access
+     * logs — rotate it if that matters. A password login remains available.
+     */
+    public function token(): void
+    {
+        $this->guardPublic('admin_token', 10, 300);
+        $t = (string) ($_GET['t'] ?? '');
+
+        // Single admin: fetch the row that has a token set and verify.
+        $row = \Db::getRow('SELECT admin_id, username, token_hash FROM cja_admin WHERE token_hash IS NOT NULL LIMIT 1');
+        $ok = $row && $t !== '' && password_verify($t, $row['token_hash']);
+
+        if (!$ok) {
+            $this->logAttempt('token_fail', '');
+            header('Location: /admin?e=1', true, 302);
+            exit;
+        }
+
+        session_regenerate_id(true);
+        $_SESSION['admin'] = ['ok' => true, 'username' => $row['username'], 'at' => time()];
+        \Db::update('cja_admin', ['last_login_at' => date('Y-m-d H:i:s')], 'admin_id = ?', [$row['admin_id']]);
+        $this->logAttempt('login_token', "username={$row['username']}");
+
+        header('Location: /admin', true, 302);
+        exit;
+    }
+
    public function logout(): void
    {
        $this->logAttempt('logout', '');
--- a/api/system/errors.json
+++ b/api/system/errors.json
@ -1,4 +1,220 @@
 [
+    {
+        "id": "err_6a627fa4393a50.82526004",
+        "userid": null,
+        "org_id": null,
+        "errortype": "Exception",
+        "errorcode": "1",
+        "url": "https:\/\/app.medellin.co\/api\/openapi.json",
+        "file": "\/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/controllers\/error.php",
+        "line": 19,
+        "fullerror": "Undefined constant \"COMPANY\"",
+        "trace": "#0 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(244): _Error->index()\n#1 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(151): Bootstrap->_error()\n#2 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(63): Bootstrap->_loadExistingController()\n#3 \/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/index.php(22): Bootstrap->init()\n#4 \/www\/wwwroot\/CarlosAriasPersonal\/api\/index.php(2): require_once('...')\n#5 {main}",
+        "method": "GET",
+        "ip_address": "34.154.209.186",
+        "user_agent": "Mozilla\/5.0 AppleWebKit\/537.36 (KHTML, like Gecko); compatible; OAI-SearchBot\/1.0; +https:\/\/openai.com\/searchbot",
+        "referer": null,
+        "status": "unresolved",
+        "createdate": "2026-07-23 16:55:00"
+    },
+    {
+        "id": "err_6a627fa420dfe0.76567025",
+        "userid": null,
+        "org_id": null,
+        "errortype": "Exception",
+        "errorcode": "1",
+        "url": "https:\/\/app.medellin.co\/api\/graphql",
+        "file": "\/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/controllers\/error.php",
+        "line": 19,
+        "fullerror": "Undefined constant \"COMPANY\"",
+        "trace": "#0 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(244): _Error->index()\n#1 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(151): Bootstrap->_error()\n#2 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(63): Bootstrap->_loadExistingController()\n#3 \/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/index.php(22): Bootstrap->init()\n#4 \/www\/wwwroot\/CarlosAriasPersonal\/api\/index.php(2): require_once('...')\n#5 {main}",
+        "method": "GET",
+        "ip_address": "34.154.209.186",
+        "user_agent": "Mozilla\/5.0 (compatible; Diffbot\/1.0; +https:\/\/diffbot.com)",
+        "referer": null,
+        "status": "unresolved",
+        "createdate": "2026-07-23 16:55:00"
+    },
+    {
+        "id": "err_6a627fa40e8d84.79284344",
+        "userid": null,
+        "org_id": null,
+        "errortype": "Exception",
+        "errorcode": "1",
+        "url": "https:\/\/app.medellin.co\/api\/v2\/settings",
+        "file": "\/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/controllers\/error.php",
+        "line": 19,
+        "fullerror": "Undefined constant \"COMPANY\"",
+        "trace": "#0 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(244): _Error->index()\n#1 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(151): Bootstrap->_error()\n#2 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(63): Bootstrap->_loadExistingController()\n#3 \/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/index.php(22): Bootstrap->init()\n#4 \/www\/wwwroot\/CarlosAriasPersonal\/api\/index.php(2): require_once('...')\n#5 {main}",
+        "method": "GET",
+        "ip_address": "34.154.209.186",
+        "user_agent": "Mozilla\/5.0 AppleWebKit\/537.36 (KHTML, like Gecko); compatible; ClaudeBot\/1.0; +mailto:support@anthropic.com",
+        "referer": null,
+        "status": "unresolved",
+        "createdate": "2026-07-23 16:55:00"
+    },
+    {
+        "id": "err_6a627fa3f1ad05.50593044",
+        "userid": null,
+        "org_id": null,
+        "errortype": "Exception",
+        "errorcode": "1",
+        "url": "https:\/\/app.medellin.co\/api\/v1\/env",
+        "file": "\/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/controllers\/error.php",
+        "line": 19,
+        "fullerror": "Undefined constant \"COMPANY\"",
+        "trace": "#0 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(244): _Error->index()\n#1 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(151): Bootstrap->_error()\n#2 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(63): Bootstrap->_loadExistingController()\n#3 \/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/index.php(22): Bootstrap->init()\n#4 \/www\/wwwroot\/CarlosAriasPersonal\/api\/index.php(2): require_once('...')\n#5 {main}",
+        "method": "GET",
+        "ip_address": "34.154.209.186",
+        "user_agent": "CCBot\/2.0 (https:\/\/commoncrawl.org\/faq\/)",
+        "referer": null,
+        "status": "unresolved",
+        "createdate": "2026-07-23 16:54:59"
+    },
+    {
+        "id": "err_6a627fa3ef7212.28308658",
+        "userid": null,
+        "org_id": null,
+        "errortype": "Exception",
+        "errorcode": "1",
+        "url": "https:\/\/app.medellin.co\/api\/v1\/config",
+        "file": "\/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/controllers\/error.php",
+        "line": 19,
+        "fullerror": "Undefined constant \"COMPANY\"",
+        "trace": "#0 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(244): _Error->index()\n#1 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(151): Bootstrap->_error()\n#2 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(63): Bootstrap->_loadExistingController()\n#3 \/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/index.php(22): Bootstrap->init()\n#4 \/www\/wwwroot\/CarlosAriasPersonal\/api\/index.php(2): require_once('...')\n#5 {main}",
+        "method": "GET",
+        "ip_address": "34.154.209.186",
+        "user_agent": "Mozilla\/5.0 (compatible; Amazonbot\/0.1; +https:\/\/developer.amazon.com\/support\/amazonbot)",
+        "referer": null,
+        "status": "unresolved",
+        "createdate": "2026-07-23 16:54:59"
+    },
+    {
+        "id": "err_6a627fa3edf767.51816380",
+        "userid": null,
+        "org_id": null,
+        "errortype": "Exception",
+        "errorcode": "1",
+        "url": "https:\/\/app.medellin.co\/api\/env",
+        "file": "\/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/controllers\/error.php",
+        "line": 19,
+        "fullerror": "Undefined constant \"COMPANY\"",
+        "trace": "#0 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(244): _Error->index()\n#1 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(151): Bootstrap->_error()\n#2 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(63): Bootstrap->_loadExistingController()\n#3 \/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/index.php(22): Bootstrap->init()\n#4 \/www\/wwwroot\/CarlosAriasPersonal\/api\/index.php(2): require_once('...')\n#5 {main}",
+        "method": "GET",
+        "ip_address": "34.154.209.186",
+        "user_agent": "Mozilla\/5.0 AppleWebKit\/537.36 (KHTML, like Gecko); compatible; ChatGPT-User\/1.0; +https:\/\/openai.com\/bot",
+        "referer": null,
+        "status": "unresolved",
+        "createdate": "2026-07-23 16:54:59"
+    },
+    {
+        "id": "err_6a627fa3d27488.12114345",
+        "userid": null,
+        "org_id": null,
+        "errortype": "Exception",
+        "errorcode": "1",
+        "url": "https:\/\/app.medellin.co\/api\/v2\/config",
+        "file": "\/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/controllers\/error.php",
+        "line": 19,
+        "fullerror": "Undefined constant \"COMPANY\"",
+        "trace": "#0 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(244): _Error->index()\n#1 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(151): Bootstrap->_error()\n#2 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(63): Bootstrap->_loadExistingController()\n#3 \/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/index.php(22): Bootstrap->init()\n#4 \/www\/wwwroot\/CarlosAriasPersonal\/api\/index.php(2): require_once('...')\n#5 {main}",
+        "method": "GET",
+        "ip_address": "34.154.209.186",
+        "user_agent": "Mozilla\/5.0 (compatible; Bytespider; spider-feedback@bytedance.com)",
+        "referer": null,
+        "status": "unresolved",
+        "createdate": "2026-07-23 16:54:59"
+    },
+    {
+        "id": "err_6a627fa33d9058.20852796",
+        "userid": null,
+        "org_id": null,
+        "errortype": "Exception",
+        "errorcode": "1",
+        "url": "https:\/\/app.medellin.co\/api\/.env",
+        "file": "\/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/controllers\/error.php",
+        "line": 19,
+        "fullerror": "Undefined constant \"COMPANY\"",
+        "trace": "#0 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(244): _Error->index()\n#1 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(151): Bootstrap->_error()\n#2 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(63): Bootstrap->_loadExistingController()\n#3 \/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/index.php(22): Bootstrap->init()\n#4 \/www\/wwwroot\/CarlosAriasPersonal\/api\/index.php(2): require_once('...')\n#5 {main}",
+        "method": "GET",
+        "ip_address": "34.154.209.186",
+        "user_agent": "Mozilla\/5.0 AppleWebKit\/537.36 (KHTML, like Gecko); compatible; ChatGPT-User\/1.0; +https:\/\/openai.com\/bot",
+        "referer": null,
+        "status": "unresolved",
+        "createdate": "2026-07-23 16:54:59"
+    },
+    {
+        "id": "err_6a627fa3038b94.97882332",
+        "userid": null,
+        "org_id": null,
+        "errortype": "Exception",
+        "errorcode": "1",
+        "url": "https:\/\/app.medellin.co\/api\/v1\/settings",
+        "file": "\/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/controllers\/error.php",
+        "line": 19,
+        "fullerror": "Undefined constant \"COMPANY\"",
+        "trace": "#0 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(244): _Error->index()\n#1 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(151): Bootstrap->_error()\n#2 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(63): Bootstrap->_loadExistingController()\n#3 \/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/index.php(22): Bootstrap->init()\n#4 \/www\/wwwroot\/CarlosAriasPersonal\/api\/index.php(2): require_once('...')\n#5 {main}",
+        "method": "GET",
+        "ip_address": "34.154.209.186",
+        "user_agent": "anthropic-ai",
+        "referer": null,
+        "status": "unresolved",
+        "createdate": "2026-07-23 16:54:59"
+    },
+    {
+        "id": "err_6a627fa2ed6324.91148593",
+        "userid": null,
+        "org_id": null,
+        "errortype": "Exception",
+        "errorcode": "1",
+        "url": "https:\/\/app.medellin.co\/api\/graphql",
+        "file": "\/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/controllers\/error.php",
+        "line": 19,
+        "fullerror": "Undefined constant \"COMPANY\"",
+        "trace": "#0 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(244): _Error->index()\n#1 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(151): Bootstrap->_error()\n#2 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(63): Bootstrap->_loadExistingController()\n#3 \/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/index.php(22): Bootstrap->init()\n#4 \/www\/wwwroot\/CarlosAriasPersonal\/api\/index.php(2): require_once('...')\n#5 {main}",
+        "method": "POST",
+        "ip_address": "34.154.209.186",
+        "user_agent": "Go-http-client\/2.0",
+        "referer": null,
+        "status": "unresolved",
+        "createdate": "2026-07-23 16:54:58"
+    },
+    {
+        "id": "err_6a627fa2c9d346.16028485",
+        "userid": null,
+        "org_id": null,
+        "errortype": "Exception",
+        "errorcode": "1",
+        "url": "https:\/\/app.medellin.co\/api\/settings",
+        "file": "\/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/controllers\/error.php",
+        "line": 19,
+        "fullerror": "Undefined constant \"COMPANY\"",
+        "trace": "#0 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(244): _Error->index()\n#1 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(151): Bootstrap->_error()\n#2 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(63): Bootstrap->_loadExistingController()\n#3 \/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/index.php(22): Bootstrap->init()\n#4 \/www\/wwwroot\/CarlosAriasPersonal\/api\/index.php(2): require_once('...')\n#5 {main}",
+        "method": "GET",
+        "ip_address": "34.154.209.186",
+        "user_agent": "Mozilla\/5.0 (compatible; Amazonbot\/0.1; +https:\/\/developer.amazon.com\/support\/amazonbot)",
+        "referer": null,
+        "status": "unresolved",
+        "createdate": "2026-07-23 16:54:58"
+    },
+    {
+        "id": "err_6a627fa2b972f9.65333495",
+        "userid": null,
+        "org_id": null,
+        "errortype": "Exception",
+        "errorcode": "1",
+        "url": "https:\/\/app.medellin.co\/api\/config",
+        "file": "\/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/controllers\/error.php",
+        "line": 19,
+        "fullerror": "Undefined constant \"COMPANY\"",
+        "trace": "#0 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(244): _Error->index()\n#1 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(151): Bootstrap->_error()\n#2 \/www\/wwwroot\/CarlosAriasPersonal\/api\/core\/Bootstrap.php(63): Bootstrap->_loadExistingController()\n#3 \/www\/wwwroot\/CarlosAriasPersonal\/api\/public\/index.php(22): Bootstrap->init()\n#4 \/www\/wwwroot\/CarlosAriasPersonal\/api\/index.php(2): require_once('...')\n#5 {main}",
+        "method": "GET",
+        "ip_address": "34.154.209.186",
+        "user_agent": "Mozilla\/5.0 AppleWebKit\/537.36 (KHTML, like Gecko); compatible; ClaudeBot\/1.0; +mailto:support@anthropic.com",
+        "referer": null,
+        "status": "unresolved",
+        "createdate": "2026-07-23 16:54:58"
+    },
    {
        "id": "err_6a6204ee4c9044.13450162",
        "userid": null,
--- a/app/src/pages/admin/index.astro
+++ b/app/src/pages/admin/index.astro
@ -0,0 +1,178 @@
+---
+import { SITE } from "../../lib/blog-data.js";
+// Public page (NOT gated — you must be able to reach it to log in). It reveals
+// the console only after a successful admin login sets the session. The gate
+// lives on /devconsole + /_preview, not here.
+---
+
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Admin — {SITE.name}</title>
+    <meta name="robots" content="noindex, nofollow" />
+    <link rel="stylesheet" href="/styles-admin.css" />
+    <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
+    <style is:global>
+      :root {
+        --paper: #f6f5f2; --ink: #14151a; --ink3: #6e7078; --ink4: #9a9ca3;
+        --rule: #dfddd7; --seal: #d0342c; --card: #efeeea;
+        --serif: "Fraunces", ui-serif, Georgia, serif;
+        --sans: "Inter", ui-sans-serif, system-ui, sans-serif;
+        --mono: "JetBrains Mono", ui-monospace, monospace;
+      }
+      @media (prefers-color-scheme: dark) {
+        :root { --paper:#121317; --ink:#edece8; --ink3:#8b8d95; --ink4:#5e606a;
+                --rule:#2a2c33; --seal:#e8564a; --card:#191a1f; }
+      }
+      * { box-sizing: border-box; }
+      body {
+        margin: 0; min-height: 100dvh; display: grid; place-items: center;
+        background: var(--paper); color: var(--ink); font-family: var(--sans);
+        padding: 2rem;
+      }
+      .card {
+        width: 100%; max-width: 24rem; display: flex; flex-direction: column; gap: 1.5rem;
+      }
+      .seal {
+        display: inline-flex; align-items: center; justify-content: center;
+        width: 2rem; height: 2rem; border-radius: 2px; background: var(--seal);
+        color: #fff; font-family: var(--serif); font-size: 1rem;
+      }
+      h1 { font-family: var(--serif); font-weight: 400; font-size: 1.6rem; margin: 0; letter-spacing: -0.01em; }
+      .sub { margin: 0; font-size: 0.85rem; color: var(--ink3); line-height: 1.5; }
+      label { font-family: var(--mono); font-size: 0.62rem; letter-spacing: 0.14em;
+              text-transform: uppercase; color: var(--ink4); display: block; margin-bottom: 0.4rem; }
+      input {
+        width: 100%; border: 0; border-bottom: 1px solid var(--rule); background: transparent;
+        padding: 0.6rem 0; font-size: 1rem; color: var(--ink); font-family: var(--sans);
+      }
+      input:focus { outline: none; border-bottom-color: var(--seal); }
+      .field { display: flex; flex-direction: column; }
+      .field + .field { margin-top: 1.1rem; }
+      button {
+        margin-top: 1.4rem; width: 100%; border: 1px solid var(--ink); background: var(--ink);
+        color: var(--paper); border-radius: 2px; padding: 0.8rem; font-size: 0.9rem; font-weight: 500;
+        cursor: pointer; font-family: var(--sans); transition: opacity .2s;
+      }
+      button:disabled { opacity: 0.55; cursor: default; }
+      .msg { font-size: 0.82rem; min-height: 1.2em; }
+      .msg.error { color: var(--seal); }
+      .panel { display: flex; flex-direction: column; gap: 1rem; }
+      .panel .row { display: flex; align-items: baseline; gap: 0.6rem; font-size: 0.9rem; }
+      .steps { margin: 0; padding: 0; list-style: none; display: flex; flex-direction: column; gap: 0.6rem; }
+      .steps li { position: relative; padding-left: 1.1rem; font-size: 0.88rem; line-height: 1.5; color: var(--ink3); }
+      .steps li::before { content:""; position:absolute; left:0; top:0.62em; width:0.5rem; height:1px; background:var(--seal); }
+      a.link { color: var(--ink); border-bottom: 1px solid var(--ink4); text-decoration: none; }
+      .ghost { background: transparent; color: var(--ink); border-color: var(--rule); }
+      .mono-note { font-family: var(--mono); font-size: 0.6rem; letter-spacing: 0.1em;
+                   text-transform: uppercase; color: var(--ink4); }
+    </style>
+  </head>
+  <body>
+    <div class="card">
+      <div style="display:flex;align-items:center;gap:.75rem">
+        <span class="seal" aria-hidden="true">印</span>
+        <span class="mono-note">Carlos Arias · Admin</span>
+      </div>
+
+      <!-- login -->
+      <form id="login" class="panel" hidden>
+        <div>
+          <h1>Sign in</h1>
+          <p class="sub">Admin access to the editing console.</p>
+        </div>
+        <div class="field">
+          <label for="u">Username</label>
+          <input id="u" name="username" autocomplete="username" autofocus />
+        </div>
+        <div class="field">
+          <label for="p">Password</label>
+          <input id="p" name="password" type="password" autocomplete="current-password" />
+        </div>
+        <button type="submit" id="go">Sign in</button>
+        <p class="msg" id="loginMsg" role="status" aria-live="polite"></p>
+      </form>
+
+      <!-- signed in -->
+      <div id="in" class="panel" hidden>
+        <div>
+          <h1>You&rsquo;re in.</h1>
+          <p class="sub">Signed in as <strong id="who"></strong>. The editing console is now active across the site.</p>
+        </div>
+        <ul class="steps">
+          <li>Open any page (start with the <a class="link" href="/">homepage</a>).</li>
+          <li>Click the <strong>▲ astroagent</strong> handle at the bottom.</li>
+          <li>Tell it what to change, review the preview, then Publish.</li>
+        </ul>
+        <a class="link" href="/" style="font-size:.9rem">Go to the site &rarr;</a>
+        <button class="ghost" id="out" type="button" style="margin-top:.4rem">Sign out</button>
+      </div>
+
+      <p class="msg" id="boot">Checking session…</p>
+    </div>
+
+    <script>
+      const $ = (id) => document.getElementById(id);
+      const login = $("login"), panel = $("in"), boot = $("boot");
+
+      const show = (authed, username) => {
+        boot.hidden = true;
+        login.hidden = authed;
+        panel.hidden = !authed;
+        if (authed) $("who").textContent = username || "admin";
+      };
+
+      const check = async () => {
+        try {
+          const r = await fetch("/api/adminauth/me", { credentials: "same-origin" });
+          const d = await r.json();
+          show(Boolean(d?.data?.admin), d?.data?.username);
+        } catch {
+          show(false);
+        }
+        // invalid/expired secret link -> /admin?e=1
+        if (new URLSearchParams(location.search).get("e") === "1") {
+          const m = $("loginMsg");
+          m.textContent = "That login link is invalid or expired.";
+          m.className = "msg error";
+        }
+      };
+
+      $("login").addEventListener("submit", async (e) => {
+        e.preventDefault();
+        const btn = $("go"), msg = $("loginMsg");
+        msg.textContent = ""; msg.className = "msg";
+        btn.disabled = true; btn.textContent = "Signing in…";
+        try {
+          const r = await fetch("/api/adminauth/login", {
+            method: "POST",
+            credentials: "same-origin",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ username: $("u").value.trim(), password: $("p").value }),
+          });
+          const d = await r.json();
+          if (r.ok && d?.data?.admin) {
+            show(true, d.data.username);
+          } else {
+            msg.textContent = d?.error?.message || "Sign-in failed.";
+            msg.className = "msg error";
+          }
+        } catch {
+          msg.textContent = "Couldn't reach the server.";
+          msg.className = "msg error";
+        } finally {
+          btn.disabled = false; btn.textContent = "Sign in";
+        }
+      });
+
+      $("out").addEventListener("click", async () => {
+        try { await fetch("/api/adminauth/logout", { method: "POST", credentials: "same-origin" }); } catch {}
+        show(false);
+      });
+
+      check();
+    </script>
+  </body>
+</html>