fix: improve init prompts, prevent duplicate frontmatter, use American English

Author: rejojer

openkb/agent/query.py

@@ -25,10 +25,12 @@
    `full_text` frontmatter field with the path to the original document content:
    - Short documents (doc_type: short): read_file with that path.
    - PageIndex documents (doc_type: pageindex): use get_page_content(doc_name, pages)
-     to read specific pages. The summary shows document tree structure with page ranges.
-5. Synthesise a clear, well-cited answer grounded in wiki content.
+     with tight page ranges. The summary shows document tree structure with page
+     ranges to help you target. Never fetch the whole document.
+5. Synthesize a clear, well-cited answer grounded in wiki content.
 
-Before each tool call, briefly state what you are about to do.
+Answer based only on wiki content. Before each tool call, briefly state what you
+are about to do. Be concise.
 
 If you cannot find relevant information, say so clearly.
 """

openkb/cli.py

@@ -257,14 +257,20 @@ def init():
 
     # Interactive prompts
     model = click.prompt(
-        "Model (e.g. gpt-5.4, anthropic/claude-sonnet-4-6, gemini/gemini-3.1-pro-preview)",
+        f"Model (e.g. gpt-5.4, anthropic/claude-sonnet-4-6) [default: {DEFAULT_CONFIG['model']}]",
         default=DEFAULT_CONFIG["model"],
+        show_default=False,
+    )
+    language = click.prompt(
+        f"Language [default: {DEFAULT_CONFIG['language']}]",
+        default=DEFAULT_CONFIG["language"],
+        show_default=False,
     )
-    language = click.prompt("Language", default=DEFAULT_CONFIG["language"])
     pageindex_threshold = click.prompt(
-        "PageIndex threshold (pages)",
+        f"PageIndex threshold (pages) [default: {DEFAULT_CONFIG['pageindex_threshold']}]",
         default=DEFAULT_CONFIG["pageindex_threshold"],
         type=int,
+        show_default=False,
     )
     # Create directory structure
     Path("raw").mkdir(exist_ok=True)
@@ -295,7 +301,7 @@ def init():
     # Register this KB in the global config
     register_kb(Path.cwd())
 
-    click.echo("Knowledge base initialised.")
+    click.echo("Knowledge base initialized.")
 
 
 @cli.command()

openkb/lint.py

@@ -29,7 +29,7 @@ def _read_md(path: Path) -> str:
 def _all_wiki_pages(wiki: Path) -> dict[str, Path]:
     """Return a mapping of stem/relative-path → absolute Path for all .md files.
 
-    Keys are normalised: 'concepts/attention', 'summaries/paper', 'index', etc.
+    Keys are normalized: 'concepts/attention', 'summaries/paper', 'index', etc.
     """
     pages: dict[str, Path] = {}
     for md in wiki.rglob("*.md"):