Files
marqdo/scripts/migrate-v02-syntax.py
cflmyandCursor 63e5be80ab Add v0.2 surface syntax, writeback/subtask stdlib, and view input deferral.
Use + for parameters, ordered-list branches, backtick identifiers, and quoted strings with escapes. Add writeback and subtask host libs, optional parameter defaults, narrative-bold comment fix, and defer view execution until preset stdin is submitted.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-06 17:52:33 +08:00

62 lines
1.6 KiB
Python

#!/usr/bin/env python3
"""One-shot migrate v0.2: params + `name`, foreach [`i`](`xs`)."""
from __future__ import annotations
import re
import sys
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
SKIP_DIRS = {"man-test", "target", ".git", "node_modules"}
PARAM_RE = re.compile(
r"^(\s+)- ([A-Za-z_\u4e00-\u9fff][A-Za-z0-9_\u4e00-\u9fff]*)(=(.*))?\s*$"
)
FOREACH_RE = re.compile(r"^(\s*)- \[([^\]]+)\]\(([^)]+)\)\s*$")
def wrap_id(name: str) -> str:
name = name.strip()
if name.startswith("`") and name.endswith("`"):
return name
return f"`{name}`"
def migrate_line(line: str) -> str:
m = FOREACH_RE.match(line)
if m:
indent, item, coll = m.groups()
return f"{indent}- [{wrap_id(item)}]({wrap_id(coll)})\n"
m = PARAM_RE.match(line)
if m:
indent, name, _, default = m.groups()
if default is not None:
return f"{indent}+ {wrap_id(name)}={default.rstrip()}\n"
return f"{indent}+ {wrap_id(name)}\n"
return line
def should_skip(path: Path) -> bool:
return any(part in SKIP_DIRS for part in path.parts)
def main() -> int:
changed = 0
for path in sorted(ROOT.rglob("*.mq.md")):
if should_skip(path):
continue
text = path.read_text(encoding="utf-8")
lines = text.splitlines(keepends=True)
out = [migrate_line(ln) for ln in lines]
new_text = "".join(out)
if new_text != text:
path.write_text(new_text, encoding="utf-8")
print(path.relative_to(ROOT))
changed += 1
print(f"migrated {changed} files")
return 0
if __name__ == "__main__":
sys.exit(main())