Refresh Wiki Graph public docs#103
Merged
Merged
Conversation
Summary by CodeRabbit
WalkthroughChangesThis PR rebrands documentation from SpineDigest to Wiki Graph, rewriting README files and removing several standalone architecture/CLI/library/quickstart/ai-agents docs in English and Chinese. It unifies CLI content input handling across chapter and metadata commands to use Sequence Diagram(s)sequenceDiagram
participant User
participant CLIArgs as args.ts
participant ArchiveChapter as archive-chapter.ts
participant ArchiveView as archive-view.ts
User->>CLIArgs: chapter add --input <path|->
CLIArgs->>CLIArgs: normalize args (reject --stage)
CLIArgs->>ArchiveChapter: parsed args (no addStage)
ArchiveChapter->>ArchiveChapter: readContentText(args)
ArchiveChapter->>ArchiveView: formatTextStreamRangeUri(sentence indices)
ArchiveView-->>ArchiveChapter: 1-based sentence range URI
ArchiveChapter-->>User: chapter created (planned or sourced)
Possibly related PRs
🚥 Pre-merge checks | ✅ 3 | ❌ 1❌ Failed checks (1 warning)
✅ Passed checks (3 passed)
✨ Finishing Touches✨ Simplify code
Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Caution
Some comments are outside the diff and can’t be posted inline due to platform limitations.
⚠️ Outside diff range comments (2)
data/help/commands/maintenance/chapter/add.jinja (1)
10-21: 🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick winRemove
--llmfrom chapter add help
chapter addrejects--llmin the CLI parser, so this usage line is stale. Drop it fromdata/help/commands/maintenance/chapter/add.jinja(and the shared chapter help if that template feeds this output).🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@data/help/commands/maintenance/chapter/add.jinja` around lines 10 - 21, The `chapter add` help text is out of sync with the CLI parser because it still advertises `--llm`, which the command rejects. Update the usage line in the `add.jinja` template to remove `--llm`, and check the shared chapter help template if it generates the same `chapter add` output so both stay consistent with the `chapter add` command behavior.src/cli/args.ts (1)
856-921: 🎯 Functional Correctness | 🟡 Minor | ⚡ Quick winHandle
.../meta --helpin URI-first help routing.parseArchiveUriFirstArguments()callsclassifyArchiveUriHelpTarget()before metadata parsing, so a URI likewikg://.../meta --helpstill reaches this switch and throwsUnknown Wiki Graph URI target. Add ametatarget here or route metadata URIs through the metadata help path.🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@src/cli/args.ts` around lines 856 - 921, `classifyArchiveUriHelpTarget()` does not recognize metadata URIs, so `wikg://.../meta --help` is being rejected as an unknown target. Update the URI-first help routing in `src/cli/args.ts` to either map `meta` to the metadata help target or pass metadata URIs into the existing metadata help path before this classifier runs. Use the existing `parseArchiveUriFirstArguments()` and `classifyArchiveUriHelpTarget()` flow to add the missing `meta` handling without affecting the other archive URI targets.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Outside diff comments:
In `@data/help/commands/maintenance/chapter/add.jinja`:
- Around line 10-21: The `chapter add` help text is out of sync with the CLI
parser because it still advertises `--llm`, which the command rejects. Update
the usage line in the `add.jinja` template to remove `--llm`, and check the
shared chapter help template if it generates the same `chapter add` output so
both stay consistent with the `chapter add` command behavior.
In `@src/cli/args.ts`:
- Around line 856-921: `classifyArchiveUriHelpTarget()` does not recognize
metadata URIs, so `wikg://.../meta --help` is being rejected as an unknown
target. Update the URI-first help routing in `src/cli/args.ts` to either map
`meta` to the metadata help target or pass metadata URIs into the existing
metadata help path before this classifier runs. Use the existing
`parseArchiveUriFirstArguments()` and `classifyArchiveUriHelpTarget()` flow to
add the missing `meta` handling without affecting the other archive URI targets.
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: f6fef936-5158-494e-a313-f1c487683cd1
📒 Files selected for processing (38)
README.mdREADME_zh-CN.mddata/help/commands/maintenance/chapter.jinjadata/help/commands/maintenance/chapter/add.jinjadata/help/commands/maintenance/chapter/set-source.jinjadata/help/commands/maintenance/chapter/set-summary.jinjadata/help/commands/maintenance/chapter/tree.jinjadata/help/commands/maintenance/meta.jinjadata/help/commands/predicate.jinjadata/help/commands/uri.jinjadata/help/topics/format.jinjadata/help/topics/uri.jinjadocs/en/ai-agents.mddocs/en/architecture.mddocs/en/cli.mddocs/en/library.mddocs/en/quickstart.mddocs/fragment-sizing.mddocs/releasing.mddocs/zh-CN/ai-agents.mddocs/zh-CN/architecture.mddocs/zh-CN/cli.mddocs/zh-CN/library.mddocs/zh-CN/quickstart.mdsrc/archive/query/archive-view.tssrc/cli/archive-chapter.tssrc/cli/archive.tssrc/cli/args.tssrc/cli/object-metadata.tssrc/evidence-selection/README.mdtest/README.mdtest/archive/query/archive-view.test.tstest/cli/README.mdtest/cli/archive-chapter.test.tstest/cli/archive.test.tstest/cli/args.test.tstest/cli/object-metadata.test.tstest/fixtures/README.md
💤 Files with no reviewable changes (16)
- docs/zh-CN/library.md
- docs/releasing.md
- src/evidence-selection/README.md
- test/cli/README.md
- docs/en/library.md
- docs/en/quickstart.md
- test/README.md
- docs/en/cli.md
- docs/zh-CN/ai-agents.md
- docs/en/architecture.md
- docs/zh-CN/architecture.md
- docs/zh-CN/cli.md
- test/fixtures/README.md
- docs/zh-CN/quickstart.md
- docs/en/ai-agents.md
- docs/fragment-sizing.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Validation