From f890ae833256b7982501eaa9e55f1c6283a33fa1 Mon Sep 17 00:00:00 2001
From: m00d <hellm00d@users.noreply.github.com>
Date: Wed, 1 Oct 2025 07:06:06 +0200
Subject: [PATCH] Add context snapshot and drop duplicate MLFS metadata

---
 ai/context.md                                 |  19 +++
 ai/metadata/packages/mlfs/binutils-pass1.json | 147 ------------------
 2 files changed, 19 insertions(+), 147 deletions(-)
 create mode 100644 ai/context.md
 delete mode 100644 ai/metadata/packages/mlfs/binutils-pass1.json

diff --git a/ai/context.md b/ai/context.md
new file mode 100644
index 0000000..59111b9
--- /dev/null
+++ b/ai/context.md
@@ -0,0 +1,19 @@
+# Repository Context Snapshot
+
+- `README.md`, `docs/ARCHITECTURE.md`, and `docs/METADATA_PIPELINE.md` describe
+  the crate structure, CLI entry points, and metadata workflows. Consult them
+  first when revisiting the project.
+- `metadata_indexer` now supports a `refresh` command that pulls jhalfs
+  `wget-list`/`md5sums` manifests into `ai/metadata/cache/` and the `harvest`
+  command automatically draws URLs and checksums from those manifests.
+- AI state lives under `ai/`:
+  - `ai/personas.json`, `ai/tasks.json`, `ai/bugs.json` track personas,
+    outstanding work, and known issues.
+  - `ai/metadata/` stores package records plus the JSON schema.
+  - `ai/notes.md` captures ongoing research ideas (e.g., deeper BLFS/GLFS
+    manifest coverage).
+- Duplicate MLFS metadata entries were pruned (`binutils-pass1.json` removed in
+  favour of the `binutils-pass-1.json` slug).
+
+This file is intended as a quick orientation checkpoint alongside the richer
+architecture docs.
diff --git a/ai/metadata/packages/mlfs/binutils-pass1.json b/ai/metadata/packages/mlfs/binutils-pass1.json
deleted file mode 100644
index 303ca2d..0000000
--- a/ai/metadata/packages/mlfs/binutils-pass1.json
+++ /dev/null
@@ -1,147 +0,0 @@
-{
-  "schema_version": "v0.1.0",
-  "package": {
-    "id": "mlfs/binutils/pass1",
-    "name": "Binutils",
-    "upstream": "gnu/binutils",
-    "version": "2.45",
-    "book": "mlfs",
-    "chapter": 5,
-    "section": "5.02",
-    "stage": "cross-toolchain",
-    "variant": "Pass 1",
-    "anchors": {
-      "section": "https://linuxfromscratch.org/~thomas/multilib-m32/chapter05/binutils-pass1.html#ch-tools-binutils-pass1"
-    }
-  },
-  "source": {
-    "urls": [
-      {
-        "url": "https://ftp.gnu.org/gnu/binutils/binutils-2.45.tar.xz",
-        "kind": "primary"
-      },
-      {
-        "url": "https://ftpmirror.gnu.org/binutils/binutils-2.45.tar.xz",
-        "kind": "mirror"
-      }
-    ],
-    "archive": "binutils-2.45.tar.xz"
-  },
-  "artifacts": {
-    "sbu": 1,
-    "disk": 678,
-    "install_prefix": "$LFS/tools"
-  },
-  "dependencies": {
-    "build": [
-      { "name": "bash" },
-      { "name": "coreutils" },
-      { "name": "gcc", "optional": true }
-    ],
-    "runtime": []
-  },
-  "environment": {
-    "variables": [
-      {
-        "name": "LFS",
-        "description": "Absolute path to mounted LFS workspace"
-      },
-      {
-        "name": "LFS_TGT",
-        "description": "Target triple for cross toolchain"
-      }
-    ],
-    "users": []
-  },
-  "build": [
-    {
-      "phase": "setup",
-      "commands": [
-        "tar -xf binutils-2.45.tar.xz",
-        "cd binutils-2.45",
-        "mkdir -v build",
-        "cd build"
-      ]
-    },
-    {
-      "phase": "configure",
-      "commands": [
-        "../configure --prefix=$LFS/tools \\",
-        "             --with-sysroot=$LFS \\",
-        "             --target=$LFS_TGT   \\",
-        "             --disable-nls       \\",
-        "             --enable-gprofng=no \\",
-        "             --disable-werror    \\",
-        "             --enable-new-dtags  \\",
-        "             --enable-default-hash-style=gnu"
-      ],
-      "cwd": "build"
-    },
-    {
-      "phase": "build",
-      "commands": [
-        "make"
-      ],
-      "cwd": "build"
-    },
-    {
-      "phase": "test",
-      "commands": [
-        "make -k check"
-      ],
-      "cwd": "build",
-      "notes": "Tests are optional for cross-toolchain; failures can be ignored"
-    },
-    {
-      "phase": "install",
-      "commands": [
-        "make install"
-      ],
-      "cwd": "build"
-    }
-  ],
-  "optimizations": {
-    "enable_lto": true,
-    "enable_pgo": true,
-    "cflags": ["-O3", "-flto", "-fprofile-generate"],
-    "ldflags": ["-flto", "-fprofile-generate"],
-    "profdata": null
-  },
-  "tests": [
-    {
-      "commands": [
-        "make -k check"
-      ],
-      "optional": true,
-      "expected_failures": ["gas/run/elf-x86-64-reloc.sh"]
-    }
-  ],
-  "post_install": [
-    {
-      "commands": [
-        "rm -v $LFS/tools/lib/libbfd.a",
-        "rm -v $LFS/tools/lib/libctf-nobfd.a"
-      ],
-      "description": "Remove static libraries per LFS guidance"
-    }
-  ],
-  "notes": [
-    {
-      "severity": "warning",
-      "text": "Ensure the host uses recent flex/bison to avoid configure warnings."
-    }
-  ],
-  "provenance": {
-    "book_release": "ml-12.4-40-multilib",
-    "page_url": "https://linuxfromscratch.org/~thomas/multilib-m32/chapter05/binutils-pass1.html",
-    "retrieved_at": "2025-03-09T00:00:00Z",
-    "content_hash": "0000000000000000000000000000000000000000000000000000000000000000"
-  },
-  "status": {
-    "state": "draft",
-    "issues": [
-      "Checksums not yet verified",
-      "Dependency list requires confirmation"
-    ]
-  }
-}