agent-wiki-cli 0.5.0__tar.gz → 0.5.1__tar.gz

{agent_wiki_cli-0.5.0/src/agent_wiki_cli.egg-info → agent_wiki_cli-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-wiki-cli
-Version: 0.5.0
+Version: 0.5.1
 Summary: CLI tool to maintain hybrid LLM Wikis for multi-language projects.
 Author-email: Denis Sivagin <denissvgn@gmail.com>
 License: MIT
@@ -246,6 +246,12 @@ parallel built-in language extraction. Sync repairs manifests with invalid
 source hashes without touching pages, and stops unusually broad diffs unless
 `--force` is used.
 
+`sync` is deterministic: it updates AST/docstring-based page skeletons and does
+not call an LLM. In agent workflows, treat sync as the first step, then inspect
+created or updated pages and replace generic `_Auto-generated from ..._`,
+copied-docstring-only, or knowable `—` placeholders with project-specific
+semantic explanations.
+
 ### `extract`
 
 Print source inventory as JSON. All registered extractors run; missing optional
@@ -368,7 +374,9 @@ llm-wiki generate-prompt --template compact
 ```
 
 The generated prompt includes change-type guidance. Installed prompt templates
-can override the default prompt body.
+can override the default prompt body. The default prompt asks agents to run
+`sync` first, then perform a semantic pass on affected pages before accepting a
+lint-clean wiki as complete.
 
 ### `mcp`
 

{agent_wiki_cli-0.5.0 → agent_wiki_cli-0.5.1}/README.md

@@ -216,6 +216,12 @@ parallel built-in language extraction. Sync repairs manifests with invalid
 source hashes without touching pages, and stops unusually broad diffs unless
 `--force` is used.
 
+`sync` is deterministic: it updates AST/docstring-based page skeletons and does
+not call an LLM. In agent workflows, treat sync as the first step, then inspect
+created or updated pages and replace generic `_Auto-generated from ..._`,
+copied-docstring-only, or knowable `—` placeholders with project-specific
+semantic explanations.
+
 ### `extract`
 
 Print source inventory as JSON. All registered extractors run; missing optional
@@ -338,7 +344,9 @@ llm-wiki generate-prompt --template compact
 ```
 
 The generated prompt includes change-type guidance. Installed prompt templates
-can override the default prompt body.
+can override the default prompt body. The default prompt asks agents to run
+`sync` first, then perform a semantic pass on affected pages before accepting a
+lint-clean wiki as complete.
 
 ### `mcp`
 

{agent_wiki_cli-0.5.0 → agent_wiki_cli-0.5.1}/pyproject.toml

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

{agent_wiki_cli-0.5.0 → agent_wiki_cli-0.5.1/src/agent_wiki_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-wiki-cli
-Version: 0.5.0
+Version: 0.5.1
 Summary: CLI tool to maintain hybrid LLM Wikis for multi-language projects.
 Author-email: Denis Sivagin <denissvgn@gmail.com>
 License: MIT
@@ -246,6 +246,12 @@ parallel built-in language extraction. Sync repairs manifests with invalid
 source hashes without touching pages, and stops unusually broad diffs unless
 `--force` is used.
 
+`sync` is deterministic: it updates AST/docstring-based page skeletons and does
+not call an LLM. In agent workflows, treat sync as the first step, then inspect
+created or updated pages and replace generic `_Auto-generated from ..._`,
+copied-docstring-only, or knowable `—` placeholders with project-specific
+semantic explanations.
+
 ### `extract`
 
 Print source inventory as JSON. All registered extractors run; missing optional
@@ -368,7 +374,9 @@ llm-wiki generate-prompt --template compact
 ```
 
 The generated prompt includes change-type guidance. Installed prompt templates
-can override the default prompt body.
+can override the default prompt body. The default prompt asks agents to run
+`sync` first, then perform a semantic pass on affected pages before accepting a
+lint-clean wiki as complete.
 
 ### `mcp`
 

{agent_wiki_cli-0.5.0 → agent_wiki_cli-0.5.1}/src/llm_wiki_cli/commands/generate_prompt_cmd.py

@@ -183,9 +183,12 @@ The project's wiki lives at `{wiki_dir}/`.
 ## Context
 {rich_context_block}
 
-Run these commands to understand what changed:
+Run these commands to update the deterministic wiki skeleton and understand what changed:
 
 ```bash
+# First update generated pages from the current source inventory
+llm-wiki sync --jobs auto --wiki-dir {quoted_wiki_dir} --src-dir {quoted_src_dir}
+
 # Changed files — compact inventory of what was modified in the last commit
 llm-wiki extract --src-dir {quoted_src_dir} --changed --summary
 
@@ -201,6 +204,17 @@ For full detail (methods, params, docstrings) on a specific file:
 llm-wiki extract --src-dir {quoted_src_dir} --paths path/to/file.py
 ```
 
+## Semantic Pass
+
+Use the sync output plus `git diff` and `extract --changed --summary` to identify
+pages that were created or updated. Inspect those affected entity/module pages
+and enrich any generated skeletons before you stop.
+
+Replace `_Auto-generated from ..._`, copied-docstring-only descriptions, and
+table `—` placeholders where semantic context is knowable from the diff or
+source. Semantic content should explain responsibility, role in the system, main
+collaborators, important behavior, and usage or constraints.
+
 ## Change-Type Focus
 
 Change type: `{effective_type}`.
@@ -213,11 +227,14 @@ Your work is done when **all** of the following are true:
 1. **`llm-wiki lint` exits 0** — no broken links, no orphan pages, no undocumented \
 classes, no stale entities, no missing modules, no broken workflow links, \
 no undocumented infrastructure files.
-2. **Only affected pages changed** — modify wiki pages that correspond to code \
+2. **Semantic pass complete** — affected entity/module pages contain \
+project-specific explanations, not just generated AST/docstring skeletons, \
+copied docstrings, `_Auto-generated from ..._`, or knowable `—` placeholders.
+3. **Only affected pages changed** — modify wiki pages that correspond to code \
 touched in the diff. Do not edit unrelated pages or reformat existing content.
-3. **`{wiki_dir}/log.md` has a new entry** — one concise line describing what changed, \
+4. **`{wiki_dir}/log.md` has a new entry** — one concise line describing what changed, \
 appended at the bottom.
-4. **`CHANGELOG.md` updated** (if applicable) — add an entry under `## [Unreleased]` \
+5. **`CHANGELOG.md` updated** (if applicable) — add an entry under `## [Unreleased]` \
 for user-facing changes. Skip for pure refactors, test-only, or doc-only commits. \
 *(Not verified by lint.)*
 

{agent_wiki_cli-0.5.0 → agent_wiki_cli-0.5.1}/src/llm_wiki_cli/services/schema.py

@@ -51,6 +51,9 @@ updated automatically on commit. You are responsible for keeping it current:
    - If sync repairs only the manifest, run the same sync command again.
    - If sync stops on a large diff, inspect the changed files first. Re-run with
      `--force` only when the broad wiki update is intentional.
+   - Inspect pages that sync created or updated. Replace generated placeholders,
+     copied-docstring-only descriptions, and knowable `—` table descriptions
+     with semantic notes from the diff and source.
    - Run `llm-wiki lint --strict --jobs auto` to verify consistency. Fix any
      issues until it exits 0.
 2. **When extractor helpers are missing** for TypeScript, Go, or Rust projects:
@@ -80,6 +83,9 @@ llm-wiki sync --jobs auto
   the wiki is stale but don't want to regenerate everything.
 - Sync creates/updates entity and module pages for new or changed files, marks
   removed files with a ⚠️ Stale header, and rebuilds `index.md`.
+- Sync output is a deterministic AST/docstring skeleton. After it runs, agents
+  must fill affected pages with project-specific semantics: responsibility,
+  system role, collaborators, important behavior, and usage or constraints.
 - Sync uses the same persistent inventory cache as lint when available. Use
   `--cache-stats` when you need to see cache behavior.
 - If no manifest exists yet (project bootstrapped by an older version), sync will
@@ -90,7 +96,8 @@ llm-wiki sync --jobs auto
 - Sync has a large-diff guard to prevent accidental mass rewrites. Use
   `llm-wiki sync --force` only after confirming the broad update is expected.
 - After sync finishes, always run `llm-wiki lint --strict --jobs auto` to verify
-  consistency.
+  structure. Passing lint is not enough if affected pages still contain generic
+  `_Auto-generated from ..._` text or unexplained placeholders.
 
 ## Using `llm-wiki context` for large codebases
 `context` produces a token-budgeted, priority-ranked snapshot of the codebase —
@@ -129,7 +136,7 @@ def _wiki_instructions(wiki_dir: str) -> str:
 - Consult relevant entity and module pages to understand existing patterns before writing new code.
 
 ## When you change code
-- Prefer `llm-wiki sync --jobs auto --wiki-dir {wiki_dir} --src-dir .` after
+- First run `llm-wiki sync --jobs auto --wiki-dir {wiki_dir} --src-dir .` after
   code changes. Sync uses the manifest, persistent inventory cache, and
   collision-aware page naming to update only affected wiki pages.
 - If sync reports that it repaired only the manifest, run the same sync command
@@ -137,7 +144,15 @@ def _wiki_instructions(wiki_dir: str) -> str:
 - If sync stops on a large diff, inspect the affected files. Use
   `llm-wiki sync --force --jobs auto --wiki-dir {wiki_dir} --src-dir .` only when
   the broad update is intentional.
-- If you update pages manually, keep edits surgical: update entity pages in
+- Then inspect the pages sync created or updated. Sync produces deterministic
+  AST/docstring skeletons; you are responsible for the semantic pass.
+- Enrich new or generic affected pages whose descriptions are `_Auto-generated
+  from ..._`, copied docstrings only, or table cells with `—` where semantic
+  context is knowable from the diff or source.
+- Semantic content should explain responsibility, role in the system, main
+  collaborators, important behavior, and usage or constraints.
+- Keep semantic edits surgical: preserve generated structure, links, tables, and
+  canonical filenames. Update only affected entity pages in
   `{wiki_dir}/entities/`, module pages in `{wiki_dir}/modules/`, workflow pages
   in `{wiki_dir}/workflows/`, infrastructure pages in `{wiki_dir}/infrastructure/`,
   and append one concise summary to `{wiki_dir}/log.md`.
@@ -169,7 +184,9 @@ Page filenames **must** match the conventions enforced by `llm-wiki lint`:
 - **Workflow pages** (`workflows/`): Free-form descriptive names.
 
 ## Quality checks
-- Your wiki changes are **complete** when `llm-wiki lint --strict --jobs auto --wiki-dir {wiki_dir} --src-dir .` exits 0.
+- Your wiki changes are **structurally valid** when `llm-wiki lint --strict --jobs auto --wiki-dir {wiki_dir} --src-dir .` exits 0.
+- Lint passing is not enough: affected pages must also have semantic
+  explanations, not only generated skeletons or copied docstrings.
 - Run lint after every wiki update. If it reports issues, fix them and re-run until it passes.
 - Run `llm-wiki lint --profile --cache-stats --wiki-dir {wiki_dir} --src-dir .`
   when lint is slow or extractor failures need machine-readable diagnostics.

{agent_wiki_cli-0.5.0 → agent_wiki_cli-0.5.1}/tests/test_generate_prompt.py

@@ -125,6 +125,17 @@ class TestGeneratePromptBuildPrompt:
         content = Path(".git/llm-wiki-prompt.txt").read_text(encoding="utf-8")
         assert "Only affected pages" in content
 
+    def test_prompt_runs_sync_before_semantic_pass(self, tmp_project):
+        """Prompt should run deterministic sync, then require semantic enrichment."""
+        args = _make_args()
+        generate_prompt_cmd.run(args)
+        content = Path(".git/llm-wiki-prompt.txt").read_text(encoding="utf-8")
+        assert "llm-wiki sync --jobs auto --wiki-dir docs/llm_wiki --src-dir ." in content
+        assert "## Semantic Pass" in content
+        assert "Semantic pass complete" in content
+        assert "_Auto-generated from ..._" in content
+        assert "generated AST/docstring skeletons" in content
+
     def test_prompt_contains_git_diff_command(self, tmp_project):
         """Prompt should instruct the agent to run git diff."""
         args = _make_args()

{agent_wiki_cli-0.5.0 → agent_wiki_cli-0.5.1}/tests/test_schema.py

@@ -36,6 +36,9 @@ def test_agent_schema_mentions_current_sync_and_lint_runtime():
     assert "LLM_WIKI_GO=/path/to/go" in content
     assert "persistent inventory cache" in content
     assert "large-diff guard" in content
+    assert "semantic pass" in content
+    assert "Lint passing is not enough" in content
+    assert "_Auto-generated from ..._" in content
 
 
 def test_ide_schema_mentions_incremental_sync_workflow():
@@ -43,6 +46,9 @@ def test_ide_schema_mentions_incremental_sync_workflow():
 
     assert "llm-wiki sync --jobs auto" in content
     assert "If sync repairs only the manifest" in content
+    assert "Sync output is a deterministic AST/docstring skeleton" in content
+    assert "Passing lint is not enough" in content
+    assert "_Auto-generated from ..._" in content
     assert "llm-wiki prepare-extractors --src-dir ." in content
     assert "LLM_WIKI_GO=/path/to/go" in content
     assert "llm-wiki lint --strict --jobs auto" in content