agent-wiki-cli 1.3.0__tar.gz → 1.3.1__tar.gz

{agent_wiki_cli-1.3.0/src/agent_wiki_cli.egg-info → agent_wiki_cli-1.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-wiki-cli
-Version: 1.3.0
+Version: 1.3.1
 Summary: CLI tool to maintain hybrid LLM Wikis for multi-language projects.
 Author-email: Denis Sivagin <denissvgn@gmail.com>
 License: MIT
@@ -115,11 +115,13 @@ helper dependencies and binaries with `llm-wiki prepare-extractors`. Lint, CI,
 and extract never run `npm install`, `go build`, `go run`, `cargo build`,
 `cargo run`, or `ghc` automatically.
 
-Source discovery honors `.gitignore` before extractors run. A root, unanchored
-`lib/` rule is treated as a generic build-output pattern for TypeScript
-projects, so `.ts`, `.tsx`, `.js`, and `.jsx` files under `src/lib/` remain
-first-party source; top-level `lib/`, excluded dependency/build directories,
-and explicit nested `.gitignore` rules still stay excluded. Generated agent
+Source discovery honors `.gitignore` before extractors run. Unescaped trailing
+ASCII spaces in ignore entries are ignored, while `\ ` preserves a literal
+final space. A root, unanchored `lib/` rule is treated as a generic build-output
+pattern for TypeScript projects, so `.ts`, `.tsx`, `.js`, and `.jsx` files under
+`src/lib/` remain first-party source; top-level `lib/`, excluded
+dependency/build directories, and explicit nested `.gitignore` rules still stay
+excluded. Generated agent
 worktree copies such as `.claude/worktrees/**` are excluded from default
 snapshots; pass an exact `--paths` entry if you intentionally want to inspect
 one file there.
@@ -240,9 +242,17 @@ Install a post-commit hook:
 llm-wiki install-hook
 ```
 
-`init` writes the selected agent and quality-hint setting to
+`init` writes the selected agent and instruction preferences to
 `.git/.llm-wiki-agent` when the project is a Git repo. Outside Git, it falls
-back to `<wiki-dir>/.llm-wiki-agent`.
+back to `<wiki-dir>/.llm-wiki-agent`. Tool-issue reporting guidance is omitted
+by default; opt in when you want agents to create local bug-report files:
+
+```bash
+llm-wiki init --agent claude --issue-reporting
+```
+
+This only adds guidance to the generated agent instruction block. It does not
+upload reports, submit issues, or enable telemetry.
 
 ## Automation
 
@@ -299,10 +309,16 @@ Scaffold the wiki structure and agent constraint file.
 llm-wiki init --agent claude
 llm-wiki init --agent copilot --wiki-dir .wiki
 llm-wiki init --agent cursor --no-quality-hints
+llm-wiki init --agent generic --issue-reporting
 ```
 
 Supported agents are `claude`, `aider`, `opencode`, `copilot`, `cursor`, and
-`generic`.
+`generic`. `--issue-reporting` includes instructions that ask agents to record
+`llm-wiki` tool failures under the local `llm-wiki-issues/` directory. The
+instructions are off by default; use `--no-issue-reporting` to explicitly omit
+them when refreshing an existing initialization. On a refresh, omitting
+`--agent` reuses the stored agent; a project with no stored selection defaults
+to `generic`.
 
 ### `bootstrap`
 
@@ -1165,10 +1181,15 @@ llm-wiki upgrade --agent copilot
 llm-wiki upgrade --wiki-dir .wiki
 llm-wiki upgrade --force
 llm-wiki upgrade --no-quality-hints
+llm-wiki upgrade --issue-reporting
+llm-wiki upgrade --no-issue-reporting
 ```
 
 `upgrade` refreshes agent instruction blocks, wiki directories, hooks, plugin
-skill blocks, and persisted local config. For older wiki layouts, it
+skill blocks, and persisted local config. The issue-reporting pair explicitly
+enables or disables the local agent guidance; without either flag, `upgrade`
+preserves the stored preference. Configurations created before this preference
+existed default to disabled. For older wiki layouts, `upgrade`
 idempotently adds registry-standard directories such as `flows/` and missing
 `.gitkeep` files without rewriting existing index, log, semantic pages, or
 optional `dependencies.md` / `load-order.md` pages. Run `bootstrap` or `sync`

{agent_wiki_cli-1.3.0 → agent_wiki_cli-1.3.1}/README.md

@@ -84,11 +84,13 @@ helper dependencies and binaries with `llm-wiki prepare-extractors`. Lint, CI,
 and extract never run `npm install`, `go build`, `go run`, `cargo build`,
 `cargo run`, or `ghc` automatically.
 
-Source discovery honors `.gitignore` before extractors run. A root, unanchored
-`lib/` rule is treated as a generic build-output pattern for TypeScript
-projects, so `.ts`, `.tsx`, `.js`, and `.jsx` files under `src/lib/` remain
-first-party source; top-level `lib/`, excluded dependency/build directories,
-and explicit nested `.gitignore` rules still stay excluded. Generated agent
+Source discovery honors `.gitignore` before extractors run. Unescaped trailing
+ASCII spaces in ignore entries are ignored, while `\ ` preserves a literal
+final space. A root, unanchored `lib/` rule is treated as a generic build-output
+pattern for TypeScript projects, so `.ts`, `.tsx`, `.js`, and `.jsx` files under
+`src/lib/` remain first-party source; top-level `lib/`, excluded
+dependency/build directories, and explicit nested `.gitignore` rules still stay
+excluded. Generated agent
 worktree copies such as `.claude/worktrees/**` are excluded from default
 snapshots; pass an exact `--paths` entry if you intentionally want to inspect
 one file there.
@@ -209,9 +211,17 @@ Install a post-commit hook:
 llm-wiki install-hook
 ```
 
-`init` writes the selected agent and quality-hint setting to
+`init` writes the selected agent and instruction preferences to
 `.git/.llm-wiki-agent` when the project is a Git repo. Outside Git, it falls
-back to `<wiki-dir>/.llm-wiki-agent`.
+back to `<wiki-dir>/.llm-wiki-agent`. Tool-issue reporting guidance is omitted
+by default; opt in when you want agents to create local bug-report files:
+
+```bash
+llm-wiki init --agent claude --issue-reporting
+```
+
+This only adds guidance to the generated agent instruction block. It does not
+upload reports, submit issues, or enable telemetry.
 
 ## Automation
 
@@ -268,10 +278,16 @@ Scaffold the wiki structure and agent constraint file.
 llm-wiki init --agent claude
 llm-wiki init --agent copilot --wiki-dir .wiki
 llm-wiki init --agent cursor --no-quality-hints
+llm-wiki init --agent generic --issue-reporting
 ```
 
 Supported agents are `claude`, `aider`, `opencode`, `copilot`, `cursor`, and
-`generic`.
+`generic`. `--issue-reporting` includes instructions that ask agents to record
+`llm-wiki` tool failures under the local `llm-wiki-issues/` directory. The
+instructions are off by default; use `--no-issue-reporting` to explicitly omit
+them when refreshing an existing initialization. On a refresh, omitting
+`--agent` reuses the stored agent; a project with no stored selection defaults
+to `generic`.
 
 ### `bootstrap`
 
@@ -1134,10 +1150,15 @@ llm-wiki upgrade --agent copilot
 llm-wiki upgrade --wiki-dir .wiki
 llm-wiki upgrade --force
 llm-wiki upgrade --no-quality-hints
+llm-wiki upgrade --issue-reporting
+llm-wiki upgrade --no-issue-reporting
 ```
 
 `upgrade` refreshes agent instruction blocks, wiki directories, hooks, plugin
-skill blocks, and persisted local config. For older wiki layouts, it
+skill blocks, and persisted local config. The issue-reporting pair explicitly
+enables or disables the local agent guidance; without either flag, `upgrade`
+preserves the stored preference. Configurations created before this preference
+existed default to disabled. For older wiki layouts, `upgrade`
 idempotently adds registry-standard directories such as `flows/` and missing
 `.gitkeep` files without rewriting existing index, log, semantic pages, or
 optional `dependencies.md` / `load-order.md` pages. Run `bootstrap` or `sync`

{agent_wiki_cli-1.3.0 → agent_wiki_cli-1.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-wiki-cli"
-version = "1.3.0"
+version = "1.3.1"
 description = "CLI tool to maintain hybrid LLM Wikis for multi-language projects."
 readme = "README.md"
 license = {text = "MIT"}

{agent_wiki_cli-1.3.0 → agent_wiki_cli-1.3.1/src/agent_wiki_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-wiki-cli
-Version: 1.3.0
+Version: 1.3.1
 Summary: CLI tool to maintain hybrid LLM Wikis for multi-language projects.
 Author-email: Denis Sivagin <denissvgn@gmail.com>
 License: MIT
@@ -115,11 +115,13 @@ helper dependencies and binaries with `llm-wiki prepare-extractors`. Lint, CI,
 and extract never run `npm install`, `go build`, `go run`, `cargo build`,
 `cargo run`, or `ghc` automatically.
 
-Source discovery honors `.gitignore` before extractors run. A root, unanchored
-`lib/` rule is treated as a generic build-output pattern for TypeScript
-projects, so `.ts`, `.tsx`, `.js`, and `.jsx` files under `src/lib/` remain
-first-party source; top-level `lib/`, excluded dependency/build directories,
-and explicit nested `.gitignore` rules still stay excluded. Generated agent
+Source discovery honors `.gitignore` before extractors run. Unescaped trailing
+ASCII spaces in ignore entries are ignored, while `\ ` preserves a literal
+final space. A root, unanchored `lib/` rule is treated as a generic build-output
+pattern for TypeScript projects, so `.ts`, `.tsx`, `.js`, and `.jsx` files under
+`src/lib/` remain first-party source; top-level `lib/`, excluded
+dependency/build directories, and explicit nested `.gitignore` rules still stay
+excluded. Generated agent
 worktree copies such as `.claude/worktrees/**` are excluded from default
 snapshots; pass an exact `--paths` entry if you intentionally want to inspect
 one file there.
@@ -240,9 +242,17 @@ Install a post-commit hook:
 llm-wiki install-hook
 ```
 
-`init` writes the selected agent and quality-hint setting to
+`init` writes the selected agent and instruction preferences to
 `.git/.llm-wiki-agent` when the project is a Git repo. Outside Git, it falls
-back to `<wiki-dir>/.llm-wiki-agent`.
+back to `<wiki-dir>/.llm-wiki-agent`. Tool-issue reporting guidance is omitted
+by default; opt in when you want agents to create local bug-report files:
+
+```bash
+llm-wiki init --agent claude --issue-reporting
+```
+
+This only adds guidance to the generated agent instruction block. It does not
+upload reports, submit issues, or enable telemetry.
 
 ## Automation
 
@@ -299,10 +309,16 @@ Scaffold the wiki structure and agent constraint file.
 llm-wiki init --agent claude
 llm-wiki init --agent copilot --wiki-dir .wiki
 llm-wiki init --agent cursor --no-quality-hints
+llm-wiki init --agent generic --issue-reporting
 ```
 
 Supported agents are `claude`, `aider`, `opencode`, `copilot`, `cursor`, and
-`generic`.
+`generic`. `--issue-reporting` includes instructions that ask agents to record
+`llm-wiki` tool failures under the local `llm-wiki-issues/` directory. The
+instructions are off by default; use `--no-issue-reporting` to explicitly omit
+them when refreshing an existing initialization. On a refresh, omitting
+`--agent` reuses the stored agent; a project with no stored selection defaults
+to `generic`.
 
 ### `bootstrap`
 
@@ -1165,10 +1181,15 @@ llm-wiki upgrade --agent copilot
 llm-wiki upgrade --wiki-dir .wiki
 llm-wiki upgrade --force
 llm-wiki upgrade --no-quality-hints
+llm-wiki upgrade --issue-reporting
+llm-wiki upgrade --no-issue-reporting
 ```
 
 `upgrade` refreshes agent instruction blocks, wiki directories, hooks, plugin
-skill blocks, and persisted local config. For older wiki layouts, it
+skill blocks, and persisted local config. The issue-reporting pair explicitly
+enables or disables the local agent guidance; without either flag, `upgrade`
+preserves the stored preference. Configurations created before this preference
+existed default to disabled. For older wiki layouts, `upgrade`
 idempotently adds registry-standard directories such as `flows/` and missing
 `.gitkeep` files without rewriting existing index, log, semantic pages, or
 optional `dependencies.md` / `load-order.md` pages. Run `bootstrap` or `sync`

{agent_wiki_cli-1.3.0 → agent_wiki_cli-1.3.1}/src/llm_wiki_cli/cli.py

@@ -175,8 +175,8 @@ def _add_init_command(subparsers):
     init_parser.add_argument(
         "--agent",
         choices=AGENT_CHOICES,
-        default="generic",
-        help="Target agent format for rules/constraints",
+        default=None,
+        help="Target agent format (default: stored agent, or generic for a new project)",
     )
     init_parser.add_argument(
         "--wiki-dir",
@@ -186,15 +186,29 @@ def _add_init_command(subparsers):
     init_parser.add_argument(
         "--no-quality-hints",
         action="store_true",
-        default=False,
+        default=None,
         help="Omit agent quality guidelines from the constraint block",
     )
     init_parser.add_argument(
         "--no-skills",
         action="store_true",
-        default=False,
+        default=None,
         help="Skip installing the wiki-reference skill into the agent's skills directory (.claude/skills for claude, .llm-wiki/skills otherwise)",
     )
+    init_issue_reporting = init_parser.add_mutually_exclusive_group()
+    init_issue_reporting.add_argument(
+        "--issue-reporting",
+        dest="issue_reporting",
+        action="store_true",
+        default=None,
+        help="Include local agent instructions for llm-wiki tool issues; does not submit reports",
+    )
+    init_issue_reporting.add_argument(
+        "--no-issue-reporting",
+        dest="issue_reporting",
+        action="store_false",
+        help="Omit local agent instructions for reporting llm-wiki tool issues (default)",
+    )
 
 
 def _add_extract_command(subparsers):
@@ -1149,6 +1163,20 @@ def _add_upgrade_command(subparsers):
         action="store_false",
         help="Skip refreshing the wiki-reference skill in the configured agent's skills directory (.claude/skills for claude, .llm-wiki/skills otherwise)",
     )
+    upgrade_issue_reporting = upgrade_parser.add_mutually_exclusive_group()
+    upgrade_issue_reporting.add_argument(
+        "--issue-reporting",
+        dest="issue_reporting",
+        action="store_true",
+        default=None,
+        help="Include local agent instructions for llm-wiki tool issues; does not submit reports",
+    )
+    upgrade_issue_reporting.add_argument(
+        "--no-issue-reporting",
+        dest="issue_reporting",
+        action="store_false",
+        help="Omit local agent instructions for reporting llm-wiki tool issues",
+    )
 
 
 def _add_sync_command(subparsers):

{agent_wiki_cli-1.3.0 → agent_wiki_cli-1.3.1}/src/llm_wiki_cli/commands/init_cmd.py

@@ -4,12 +4,19 @@ import shutil
 import sys
 from pathlib import Path
 
-from ..config import CLI_AGENTS, DEFAULT_WIKI_DIR, validate_path, write_config
+from ..config import (
+    CLI_AGENTS,
+    DEFAULT_WIKI_DIR,
+    read_config,
+    validate_path,
+    write_config,
+)
 from ..services.io import read_md, write_md
 from ..services.schema import (
     CONSTRAINT_START as _CONSTRAINT_START,
     SCHEMA_FILENAMES,
     build_schema_content as _build_schema_content,
+    replace_schema_block,
 )
 from ..services.skills import (
     REFERENCE_SKILL_ID,
@@ -27,15 +34,18 @@ _CLI_AGENTS = CLI_AGENTS
 def run(args):
     wiki_dir = getattr(args, "wiki_dir", DEFAULT_WIKI_DIR)
     validate_path(wiki_dir, "--wiki-dir")
-    print(f"Initializing LLM Wiki with {args.agent} schema...")
+    stored = read_config(wiki_dir)
+    requested_agent = getattr(args, "agent", None)
+    agent = requested_agent or str(stored.get("agent") or "generic")
+    print(f"Initializing LLM Wiki with {agent} schema...")
 
     # Warn if the agent has a CLI executable that isn't installed
-    executable = _CLI_AGENTS.get(args.agent)
+    executable = _CLI_AGENTS.get(agent)
     if executable and not shutil.which(executable):
         print(
             f"\nWarning: '{executable}' is not installed or not on PATH.\n"
             f"The schema file will be created, but manual agent execution\n"
-            f"(`llm-wiki trigger-agent --agent {args.agent}`) will not work\n"
+            f"(`llm-wiki trigger-agent --agent {agent}`) will not work\n"
             f"until '{executable}' is installed.\n"
         )
 
@@ -71,16 +81,29 @@ def run(args):
     if not log_path.exists():
         write_md(log_path, "# Architectural Log\n\nAppend-only chronological log.\n\n")
 
-    # 3. Create or Append to Agent Schema
-    quality_hints = not getattr(args, "no_quality_hints", False)
-    filename = SCHEMA_FILENAMES.get(args.agent)
+    # 3. Create or refresh the Agent Schema. Unspecified preferences preserve an
+    # existing installation's choices; a new installation receives config defaults.
+    cli_no_quality_hints = getattr(args, "no_quality_hints", None)
+    if cli_no_quality_hints is None:
+        quality_hints = bool(stored.get("quality_hints", True))
+    else:
+        quality_hints = not cli_no_quality_hints
+    cli_issue_reporting = getattr(args, "issue_reporting", None)
+    if cli_issue_reporting is None:
+        issue_reporting = bool(stored.get("issue_reporting", False))
+    else:
+        issue_reporting = cli_issue_reporting
+    filename = SCHEMA_FILENAMES.get(agent)
     if filename:
         schema_path = Path(filename)
         # ensure parent exists (e.g. for .github/)
         schema_path.parent.mkdir(parents=True, exist_ok=True)
 
         content_to_add = _build_schema_content(
-            args.agent, wiki_dir, quality_hints=quality_hints
+            agent,
+            wiki_dir,
+            quality_hints=quality_hints,
+            issue_reporting=issue_reporting,
         )
 
         if schema_path.exists():
@@ -90,19 +113,22 @@ def run(args):
                 write_md(schema_path, existing_content + "\n\n" + content_to_add)
                 print(f"Appended agent constraints to existing file: {schema_path}")
             else:
-                print(
-                    f"Agent constraints already exist in {schema_path}, skipping append."
-                )
+                replace_schema_block(schema_path, content_to_add)
+                print(f"Refreshed agent constraints in existing file: {schema_path}")
         else:
             write_md(schema_path, content_to_add)
             print(f"Created agent schema file: {schema_path}")
 
     # 4. Install the CLI-owned wiki-reference skill that the constraint
     # block's deep-reference pointers target
-    install_skill = not getattr(args, "no_skills", False)
+    cli_no_skills = getattr(args, "no_skills", None)
+    if cli_no_skills is None:
+        install_skill = bool(stored.get("reference_skill", True))
+    else:
+        install_skill = not cli_no_skills
     if install_skill:
         try:
-            report = install_reference_skill(agent=args.agent)
+            report = install_reference_skill(agent=agent)
         except SkillsError as exc:
             print(f"Warning: could not install {REFERENCE_SKILL_ID} skill: {exc}")
         else:
@@ -126,9 +152,10 @@ def run(args):
     write_config(
         base_dir,
         {
-            "agent": args.agent,
+            "agent": agent,
             "quality_hints": quality_hints,
             "reference_skill": install_skill,
+            "issue_reporting": issue_reporting,
         },
     )
 

{agent_wiki_cli-1.3.0 → agent_wiki_cli-1.3.1}/src/llm_wiki_cli/commands/status_cmd.py

@@ -68,6 +68,8 @@ def run(args) -> None:
         print(f"Agent:           {agent} ({mode})")
         hints = config.get("quality_hints", True)
         print(f"Quality hints:   {'enabled' if hints else 'disabled'}")
+        issue_reporting = config.get("issue_reporting", False)
+        print(f"Issue reporting: {'enabled' if issue_reporting else 'disabled'}")
     else:
         print("Agent:           not configured (run `llm-wiki init --agent <agent>`)")
 

{agent_wiki_cli-1.3.0 → agent_wiki_cli-1.3.1}/src/llm_wiki_cli/commands/upgrade_cmd.py

@@ -95,13 +95,23 @@ def _resolve_agent(args, wiki_dir: str) -> str:
 
 
 def _upgrade_schema(
-    agent: str, wiki_dir: str, old_agent: str | None, *, quality_hints: bool = True
+    agent: str,
+    wiki_dir: str,
+    old_agent: str | None,
+    *,
+    quality_hints: bool = True,
+    issue_reporting: bool = False,
 ) -> str:
     """Replace or migrate the agent schema constraint block.
 
     Returns a summary message.
     """
-    new_content = build_schema_content(agent, wiki_dir, quality_hints=quality_hints)
+    new_content = build_schema_content(
+        agent,
+        wiki_dir,
+        quality_hints=quality_hints,
+        issue_reporting=issue_reporting,
+    )
     new_filename = SCHEMA_FILENAMES.get(agent)
 
     if old_agent and old_agent != agent:
@@ -228,6 +238,11 @@ def run(args):
         reference_skill = cli_skills
     else:
         reference_skill = stored.get("reference_skill", True)
+    cli_issue_reporting = getattr(args, "issue_reporting", None)
+    if cli_issue_reporting is not None:
+        issue_reporting = cli_issue_reporting
+    else:
+        issue_reporting = stored.get("issue_reporting", False)
 
     print("LLM Wiki Upgrade")
     print("=" * 40)
@@ -240,7 +255,11 @@ def run(args):
     # 1. Schema constraint block
     print("\n1. Agent Schema:")
     schema_file = _upgrade_schema(
-        agent, wiki_dir, old_agent, quality_hints=quality_hints
+        agent,
+        wiki_dir,
+        old_agent,
+        quality_hints=quality_hints,
+        issue_reporting=issue_reporting,
     )
     print(f"  Updated: {schema_file}")
     refreshed_skills = refresh_skill_blocks(agent, wiki_dir)
@@ -285,6 +304,7 @@ def run(args):
             "agent": agent,
             "quality_hints": quality_hints,
             "reference_skill": reference_skill,
+            "issue_reporting": issue_reporting,
         },
     )
 

{agent_wiki_cli-1.3.0 → agent_wiki_cli-1.3.1}/src/llm_wiki_cli/config.py

@@ -210,6 +210,7 @@ _DEFAULT_CONFIG: dict[str, object] = {
     "agent": "generic",
     "quality_hints": True,
     "reference_skill": True,
+    "issue_reporting": False,
 }
 
 
@@ -247,6 +248,53 @@ class GitIgnoreMatcher:
         return rule is not None and not rule.negated
 
 
+def _normalize_gitignore_trailing_spaces(line: str) -> str:
+    """Remove Git-insignificant trailing spaces from one ignore pattern.
+
+    Backslashes quote the next character, so escaped spaces are retained while
+    an unescaped trailing run is removed.  Decode only quoted spaces here;
+    broader gitignore escape and wildmatch semantics remain unchanged.  Tabs
+    are intentionally untouched.
+    """
+    first_trailing_space: int | None = None
+    index = 0
+    while index < len(line):
+        if line[index] == "\\":
+            first_trailing_space = None
+            index += 2
+            continue
+        if line[index] == " ":
+            if first_trailing_space is None:
+                first_trailing_space = index
+        else:
+            first_trailing_space = None
+        index += 1
+
+    if first_trailing_space is not None:
+        line = line[:first_trailing_space]
+
+    normalized: list[str] = []
+    index = 0
+    while index < len(line):
+        if line[index] != "\\":
+            normalized.append(line[index])
+            index += 1
+            continue
+
+        run_start = index
+        while index < len(line) and line[index] == "\\":
+            index += 1
+        backslash_count = index - run_start
+        if index < len(line) and line[index] == " " and backslash_count % 2:
+            normalized.append("\\" * (backslash_count - 1))
+            normalized.append(" ")
+            index += 1
+            continue
+        normalized.append("\\" * backslash_count)
+
+    return "".join(normalized)
+
+
 def _parse_gitignore_file(gitignore_path: Path, base: str = "") -> list[_GitignoreRule]:
     rules: list[_GitignoreRule] = []
     if not gitignore_path.exists():
@@ -256,6 +304,7 @@ def _parse_gitignore_file(gitignore_path: Path, base: str = "") -> list[_Gitigno
         with open(gitignore_path, "r", encoding="utf-8") as f:
             for raw in f:
                 line = raw.rstrip("\n\r")
+                line = _normalize_gitignore_trailing_spaces(line)
                 if not line or line.startswith("#"):
                     continue
                 negated = line.startswith("!")
@@ -376,7 +425,8 @@ def read_config(wiki_dir: "str | Path") -> dict:
     """Read the persisted llm-wiki config as a dict.
 
     Handles backward compatibility: if the file contains a bare agent name
-    string (pre-v0.3 format), it is treated as ``{"agent": "<value>", "quality_hints": true}``.
+    string (pre-v0.3 format), it is treated as an agent selection with all
+    current defaults applied.
 
     Returns *_DEFAULT_CONFIG* values for any missing keys.
     """

{agent_wiki_cli-1.3.0 → agent_wiki_cli-1.3.1}/src/llm_wiki_cli/services/mcp_server.py

@@ -345,6 +345,7 @@ class McpWikiService:
                     "name": agent,
                     "mode": "IDE" if agent in IDE_AGENTS else "CLI",
                     "quality_hints": bool(config.get("quality_hints", True)),
+                    "issue_reporting": bool(config.get("issue_reporting", False)),
                 }
             except Exception as exc:
                 status["agent"] = {"configured": False, "error": str(exc)}

{agent_wiki_cli-1.3.0 → agent_wiki_cli-1.3.1}/src/llm_wiki_cli/services/schema.py

@@ -110,7 +110,32 @@ _QUALITY_HINTS = """\
 """
 
 
-def _wiki_instructions(wiki_dir: str, skills_dir: str) -> str:
+def _issue_reporting_instructions(wiki_dir: str) -> str:
+    return f"""## Report llm-wiki tool issues
+If an `llm-wiki` command itself misbehaves while you use it — a crash or
+traceback, wrong or stale generated output, a diagnostic that contradicts the
+observed state, or behavior that contradicts these instructions — never work
+around it silently:
+
+- Write one report file per issue under `llm-wiki-issues/` at the project root,
+  named `llm-wiki-issues/<YYYY-MM-DD>-<short-slug>.md`. Keep reports outside
+  `{wiki_dir}/` so lint does not flag them as orphan pages.
+- Each report must include: the exact command and flags you ran, expected
+  behavior, actual behavior (trim long output to the relevant lines), minimal
+  reproduction steps, `llm-wiki --version` output, and the workaround you
+  applied, if any.
+- Then continue the original task with the safest workaround and mention the
+  report file in your final summary so the issue can be addressed upstream.
+
+"""
+
+
+def _wiki_instructions(
+    wiki_dir: str, skills_dir: str, *, issue_reporting: bool = False
+) -> str:
+    issue_reporting_instructions = (
+        _issue_reporting_instructions(wiki_dir) if issue_reporting else ""
+    )
     return f"""You are operating within an LLM Wiki architecture. The project's persistent memory is stored in `{wiki_dir}/`.
 
 ## Before you start
@@ -298,23 +323,7 @@ Page filenames **must** match the conventions enforced by `llm-wiki lint`:
   covers active extractor languages only.
 - Never leave the wiki in a state where lint reports errors.
 
-## Report llm-wiki tool issues
-If an `llm-wiki` command itself misbehaves while you use it — a crash or
-traceback, wrong or stale generated output, a diagnostic that contradicts the
-observed state, or behavior that contradicts these instructions — never work
-around it silently:
-
-- Write one report file per issue under `llm-wiki-issues/` at the project root,
-  named `llm-wiki-issues/<YYYY-MM-DD>-<short-slug>.md`. Keep reports outside
-  `{wiki_dir}/` so lint does not flag them as orphan pages.
-- Each report must include: the exact command and flags you ran, expected
-  behavior, actual behavior (trim long output to the relevant lines), minimal
-  reproduction steps, `llm-wiki --version` output, and the workaround you
-  applied, if any.
-- Then continue the original task with the safest workaround and mention the
-  report file in your final summary so the issue can be addressed upstream.
-
-## Formatting rules
+{issue_reporting_instructions}## Formatting rules
 - Entity pages must have: Location, Bases, Module link, Attributes table, Methods table, Relationships.
 - Module pages must have: Path, Imports table, Classes summary, Functions table.
 - User-flow pages have generated Mermaid call-sequence and `## Data flow`
@@ -330,13 +339,19 @@ around it silently:
 
 
 def build_schema_content(
-    agent: str, wiki_dir: str, *, quality_hints: bool = True
+    agent: str,
+    wiki_dir: str,
+    *,
+    quality_hints: bool = True,
+    issue_reporting: bool = False,
 ) -> str:
     """Build the full constraint block for the given agent and wiki directory."""
     from .skills import skills_install_dir
 
     instructions = _wiki_instructions(
-        wiki_dir, skills_install_dir(agent).as_posix()
+        wiki_dir,
+        skills_install_dir(agent).as_posix(),
+        issue_reporting=issue_reporting,
     )
     preambles = {
         "claude": f"# Project Wiki\n\nThis project uses an LLM Wiki for persistent architectural memory.\nRead `{wiki_dir}/index.md` first when starting any task.\n\n",