96 lines
3.2 KiB
Python
96 lines
3.2 KiB
Python
#!/usr/bin/env python3
|
|
# =============================================================================
|
|
# skills/ingest/scripts/index-append.py
|
|
# Insert an entry line into the correct section of wiki/index.md and keep that
|
|
# section's entries alphabetically ordered. Bumps frontmatter last_updated.
|
|
#
|
|
# NOTE: agents-genome.md and wiki-index.md claim the pre-commit hook sorts the
|
|
# index. The actual pre-commit.sh only runs the plaintext-leak check — it does
|
|
# NOT sort. This script owns the ordering instead. (If you later move sorting
|
|
# into the hook, reduce this to a plain append.)
|
|
#
|
|
# index-append.py --section Sources \
|
|
# --entry '- [[sources/foo]] — One-line summary. `maturity: draft`'
|
|
# =============================================================================
|
|
import argparse
|
|
import datetime
|
|
import re
|
|
import sys
|
|
|
|
ENTRY_RE = re.compile(r"^- \[\[")
|
|
HEADER_RE = re.compile(r"^## ")
|
|
|
|
|
|
def main() -> int:
|
|
ap = argparse.ArgumentParser()
|
|
ap.add_argument("--section", required=True,
|
|
help="Section name, e.g. Sources / Entities / Concepts / Queries / Conflicts")
|
|
ap.add_argument("--entry", required=True, help="Full index line to insert")
|
|
ap.add_argument("--file", default="wiki/index.md")
|
|
args = ap.parse_args()
|
|
|
|
try:
|
|
with open(args.file, encoding="utf-8") as fh:
|
|
lines = fh.read().splitlines()
|
|
except FileNotFoundError:
|
|
print(f"index-append: not found: {args.file}", file=sys.stderr)
|
|
return 1
|
|
|
|
today = datetime.date.today().isoformat()
|
|
|
|
# 1. Bump last_updated inside the first frontmatter block
|
|
fm_open = False
|
|
for i, ln in enumerate(lines):
|
|
if ln.strip() == "---":
|
|
if not fm_open:
|
|
fm_open = True
|
|
continue
|
|
break # end of frontmatter
|
|
if fm_open and ln.startswith("last_updated:"):
|
|
lines[i] = f"last_updated: {today}"
|
|
|
|
# 2. Locate the target section [start, end)
|
|
start = None
|
|
for i, ln in enumerate(lines):
|
|
if HEADER_RE.match(ln) and ln[3:].startswith(args.section):
|
|
start = i
|
|
break
|
|
if start is None:
|
|
print(f"index-append: section '{args.section}' not found in {args.file}",
|
|
file=sys.stderr)
|
|
return 1
|
|
|
|
end = len(lines)
|
|
for i in range(start + 1, len(lines)):
|
|
if HEADER_RE.match(lines[i]):
|
|
end = i
|
|
break
|
|
|
|
# 3. Split the section body into intro (non-entry) and entries
|
|
body = lines[start + 1:end]
|
|
intro = [ln for ln in body if not ENTRY_RE.match(ln)]
|
|
entries = [ln for ln in body if ENTRY_RE.match(ln)]
|
|
|
|
if args.entry in entries:
|
|
print(f"index-append: entry already present, skipping")
|
|
return 0
|
|
|
|
entries.append(args.entry)
|
|
entries.sort(key=str.casefold)
|
|
|
|
# Normalise intro: drop trailing blanks, keep header + comment(s)
|
|
while intro and intro[-1].strip() == "":
|
|
intro.pop()
|
|
|
|
new_section = intro + [""] + entries + [""]
|
|
lines = lines[:start + 1] + new_section + lines[end:]
|
|
|
|
with open(args.file, "w", encoding="utf-8") as fh:
|
|
fh.write("\n".join(lines) + "\n")
|
|
|
|
print(f"index-append: added to {args.section}")
|
|
return 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
sys.exit(main())
|