chore(정리): graphify · 위키 찌꺼기 — main.py 리로드 건너뜀 목록의 graphify-out · 위키 린터 스크립트
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01C6BNBFXFndbqYxu6sZuknK
This commit is contained in:
@@ -738,7 +738,6 @@ _RELOAD_SKIP = {
|
||||
"docs",
|
||||
"resources",
|
||||
"scratch",
|
||||
"graphify-out",
|
||||
"0_old",
|
||||
"db_management",
|
||||
"migrations",
|
||||
|
||||
@@ -1,131 +0,0 @@
|
||||
import os
|
||||
import re
|
||||
|
||||
WIKI_DIR = r"C:\Program_coding\임도설계 및 견적자동화 프로그램 개발\docs\wiki"
|
||||
PAGES_DIR = os.path.join(WIKI_DIR, "pages")
|
||||
CONCEPTS_DIR = os.path.join(WIKI_DIR, "concepts")
|
||||
INDEX_PATH = os.path.join(WIKI_DIR, "index.md")
|
||||
|
||||
errors = []
|
||||
warnings = []
|
||||
all_wiki_files = {} # relative_path -> absolute_path
|
||||
|
||||
# Collect all markdown files in wiki/ (ignoring graphify-out and memory directories)
|
||||
for root, dirs, files in os.walk(WIKI_DIR):
|
||||
# skip graphify-out or memory
|
||||
if "graphify-out" in root or "memory" in root:
|
||||
continue
|
||||
for file in files:
|
||||
if file.endswith(".md"):
|
||||
abs_path = os.path.join(root, file)
|
||||
rel_path = os.path.relpath(abs_path, WIKI_DIR).replace("\\", "/")
|
||||
all_wiki_files[rel_path] = abs_path
|
||||
simple_name = os.path.splitext(rel_path)[0]
|
||||
all_wiki_files[simple_name] = abs_path
|
||||
|
||||
# Read index.md content
|
||||
with open(INDEX_PATH, "r", encoding="utf-8") as f:
|
||||
index_content = f.read()
|
||||
|
||||
# Pattern for wikilinks: [[link]] or [[link|label]]
|
||||
wikilink_pat = re.compile(r"\[\[([^\]|]+)(?:\|[^\]]+)?\]\]")
|
||||
|
||||
for rel_path, abs_path in list(all_wiki_files.items()):
|
||||
if "/" not in rel_path and rel_path != "index" and rel_path != "log":
|
||||
continue
|
||||
if rel_path in ["index", "log", "index.md", "log.md"]:
|
||||
continue
|
||||
|
||||
with open(abs_path, "r", encoding="utf-8") as f:
|
||||
lines = f.readlines()
|
||||
|
||||
line_count = len(lines)
|
||||
content = "".join(lines)
|
||||
|
||||
# Rule 14: Max 100 lines
|
||||
if line_count > 100:
|
||||
warnings.append(f"[Line Count] `{rel_path}.md` exceeds 100 lines ({line_count} lines).")
|
||||
|
||||
# Check YAML Frontmatter via simple regex
|
||||
frontmatter_match = re.match(r"^---\s*\n(.*?)\n---\s*\n", content, re.DOTALL)
|
||||
if not frontmatter_match:
|
||||
errors.append(f"[Frontmatter] `{rel_path}.md` has no valid YAML frontmatter.")
|
||||
continue
|
||||
|
||||
fm_text = frontmatter_match.group(1)
|
||||
|
||||
# Simple regex parsing for status & page_id
|
||||
status_match = re.search(r"^status:\s*(\w+)", fm_text, re.MULTILINE)
|
||||
page_id_match = re.search(r"^page_id:\s*([^\n\r]+)", fm_text, re.MULTILINE)
|
||||
|
||||
if not status_match:
|
||||
errors.append(f"[Status] `{rel_path}.md` has no status field in frontmatter.")
|
||||
else:
|
||||
status = status_match.group(1).strip()
|
||||
if status not in ["draft", "stable", "stale"]:
|
||||
errors.append(
|
||||
f"[Status] `{rel_path}.md` has invalid status '{status}'. Must be draft, stable, or stale."
|
||||
)
|
||||
elif status == "stale":
|
||||
warnings.append(
|
||||
f"[Stale Page] `{rel_path}.md` is marked as stale and needs updates from raw inputs."
|
||||
)
|
||||
|
||||
# Rule 5: page_id required for pages/
|
||||
if "pages/" in rel_path:
|
||||
if not page_id_match:
|
||||
errors.append(f"[page_id] `{rel_path}.md` is in pages/ but lacks a 'page_id' field.")
|
||||
|
||||
# Check for broken wikilinks in content
|
||||
links = wikilink_pat.findall(content)
|
||||
for link in links:
|
||||
link_clean = (
|
||||
link.strip().replace("\\", "/").split("#")[0]
|
||||
) # ignore anchor for file existence check
|
||||
if not link_clean:
|
||||
continue
|
||||
found = False
|
||||
|
||||
# 1. Absolute link from vault root (e.g. concepts/storage_paths)
|
||||
if link_clean in all_wiki_files:
|
||||
found = True
|
||||
# 2. Simple name match (e.g. storage_paths, B01_frontend)
|
||||
elif link_clean.split("/")[-1] in all_wiki_files:
|
||||
found = True
|
||||
# 3. Handle subpages like [[B01_Dashboard/B01_frontend]]
|
||||
elif f"pages/{link_clean}" in all_wiki_files:
|
||||
found = True
|
||||
elif f"concepts/{link_clean}" in all_wiki_files:
|
||||
found = True
|
||||
# 4. Handle nested directory patterns
|
||||
elif link_clean.startswith("../"):
|
||||
# Resolve relative link
|
||||
curr_dir = os.path.dirname(rel_path)
|
||||
resolved = os.path.normpath(os.path.join(curr_dir, link_clean)).replace("\\", "/")
|
||||
if resolved in all_wiki_files or resolved.replace("pages/", "") in all_wiki_files:
|
||||
found = True
|
||||
|
||||
if not found:
|
||||
errors.append(f"[Broken Link] `{rel_path}.md` contains broken wikilink: [[{link}]]")
|
||||
|
||||
# Check if this file is registered in index.md (avoid orphans)
|
||||
file_base = os.path.basename(abs_path)
|
||||
file_name_no_ext = os.path.splitext(file_base)[0]
|
||||
if file_name_no_ext not in index_content:
|
||||
# check if relative path is in index
|
||||
rel_path_no_ext = rel_path.replace(".md", "")
|
||||
if (
|
||||
rel_path_no_ext not in index_content
|
||||
and rel_path_no_ext.split("/")[-1] not in index_content
|
||||
):
|
||||
warnings.append(
|
||||
f"[Orphan Page] `{rel_path}.md` is not linked or mentioned in index.md."
|
||||
)
|
||||
|
||||
print("=== LINT ERRORS ===")
|
||||
for e in sorted(list(set(errors))):
|
||||
print(e)
|
||||
print("\n=== LINT WARNINGS ===")
|
||||
for w in sorted(list(set(warnings))):
|
||||
print(w)
|
||||
print("\nLint completed.")
|
||||
Reference in New Issue
Block a user