Repository navigation
feat: ingest output standard v2 (STE-80 lint, v2 marker, page render-html) - #96
Merged
Merged
Conversation
TypedKnowledgeSchema accepts optional output_standard: v2 and html_render. Add HTML_RENDER_NOT_OPTED_IN so page render-html can refuse unmarked pages.
Check marked pages only for sentence length, hedges, diagram uncertainty, and comparison visuals. Findings stay WARN and do not change lint or health exit codes.
skillwiki ingest always stamps output_standard: v2. --html also stamps html_render: true. page render-html writes a self-contained file outside the vault for opted-in pages.
Add rungs, format table, and the four WARN buckets to wiki-ingest and wiki-lint. Include v2 sample fixtures and a draft concept page for later attended publish.
…e href schemes in render-html
Reject --out paths that resolve inside the vault through symlink aliases before mkdir/write. Skip inline code, nested Uncertainty headings, and wrapped Least-certain list items in hedge scans. Activate HTML tab panels from TOC links and URL fragments. Name actual diagram edges in sample uncertainty lists.
Parse equal-length backtick runs, treat escaped and unclosed ticks as literal text, and keep lazy Least-certain continuations in list scope.
Name interpretive grouping, simplified steps, omitted conditions, or unstated mappings. Do not invent doubt about settled source facts.
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
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
Adds ingest output standard v2: STE-80 authoring checks, a typed-page marker, and an opt-in HTML renderer. Agents write the prose; the CLI only checks marked pages.
Lint WARN buckets (marked pages only)
ste_sentence_length— prose sentences > 25 words; ordered-list items and list items under Steps/Procedure > 20 wordsste_hedge_words— whole-word hedges outside## Uncertainty,**Least certain:**lists, code, and blockquotesste_diagram_uncertainty— a Mermaid block with no**Least certain:**bullet list after itste_comparison_visual— atype: comparisonpage with neither a Markdown table nor a Mermaid blockThese are advisory WARN findings. They do not change publish, the lint exit code, health exit, or release CI on content.
New flags / command
skillwiki ingeststampsoutput_standard: v2on every new typed stubskillwiki ingest --htmlalso stampshtml_render: trueskillwiki page render-html <page> [vault] --out <file>— vault read-only; refuses unlesshtml_render: true; refuses--outinside the vault; writes one self-contained HTML file (TOC, tabs,<details>, inline CSS/JS; Mermaid as<pre class="mermaid">)Tests run
npm run typechecknpm run buildnpx vitest run packages/cli/test/(plus shared tests touched by this change)Notes
packages/cli/test/fixtures/output-standard-v2/concepts-ingest-output-standard-v2.mdfor later attended publish. Not written to any vault.