- Filter out links containing # (fragment identifiers)
- Filter out external URLs (http://, https://, ftp://, etc.)
- Only create edges to files that actually exist in file_links
- This reduces noise in the graph visualization
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
Adds comprehensive specification for fiona-assistant wiki graph command:
- Parses markdown files to extract internal links (markdown links, wikilinks)
- Builds directed graph data structure with nodes and weighted edges
- Generates interactive HTML visualization using D3.js/vis.js
- CLI integration with wiki subcommand
- Node sizing proportional to in-degree
- JSON output format support
- Settings integration
- Module structure and implementation priority
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
wiki sanity now reuses run_sanity's ProgressDisplay: one bar line
per check on a terminal, labeled progress dots on an interval when
piped or with --non-interactive; --json runs skip the display.
Non-interactive mode prints one dot per interval (Running Sanity /
Running Wiki Sanity) for both runners instead of status blocks.
SPEC 3.1.3, 4.9.5, 4.9.6 updated to match.
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
Adds interactive live progress bars (SPEC 4.9.6) and a
--non-interactive mode for piped/agent consumption. Bars draw
one line per check and redraw in place via ANSI cursor control;
non-interactive mode prints plain status blocks every configurable
interval (default 3s). Settings live in settings_dev.json's
progress section (interval, expected-seconds).
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
Implements `wiki sanity` (SPEC 3.1.3): mdlinter (custom markdown
linter with MDL001/MDL002 dead-link checks), the shared SanityRunner
engine used by both run_sanity and wiki sanity (SPEC 4.9.5), and the
fiona CLI dispatch. Tests keep the pytest check fast (64s -> 14s
with coverage) through session-scoped pristine wiki fixtures and a
minimal_wiki fixture so the full template is sanity-checked once per
session instead of once per test.
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
update_manager replaces its stubs with the full wiki update flow:
- md files update via frontmatter version comparison; locally-modified
files (version ahead or content diverged) are skipped and reported
- non-md files and settings compare SHA256; settings update merges user
values over the template
- missing template files are re-added and missing directories created,
honoring fiona.llm-wiki.ignore_files and read-only zones
- confirmation via --force/--yes or an interactive y/N prompt;
non-interactive sessions decline with a clear error
- check-update and update emit real JSON for AI agents
SPEC 3.1.2 marked implemented (SPEC 0.31.0 -> 0.32.0); todo updated.
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
wiki init now refuses re-runs with a FileExistsError that lists the
conflicting indicator files (SPEC 3.1.1) and tests verify user content
survives a refused re-run.
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
copy_directory_tree gains ignore_patterns; wiki_init reads the glob
patterns from the template's fiona-settings.json and skips matching
files (a matching directory skips its whole subtree). Everything else
copies 1:1, Python files included. Adds get_ignore_patterns with
ValueError on a malformed list, six tests, and syncs SPEC 3.1.1
(version 0.31.0).
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
Remove the redundant src/conftest.py sys.path bootstrap and move it
into src/tests/conftest.py; run_tests.py already sets PYTHONPATH and
the tests package layout puts src/ on sys.path. Verified via
run_tests.py (619/619), direct pytest without PYTHONPATH, and
run_sanity.py (all checks green).
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
Every Results summary line now carries its elapsed time as (MM:SS) and
the pass banner reads SANITY PASSED (MM:SS) with the total wall time.
The coverage line stays untimed. Documented in SPEC 4.9.4.
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
Move the compressed violations build/format logic from FrontmatterLinter
into BaseLinter as compress_violations() and format_compressed_violations(),
with the report header derived from a new linter_name class attribute.
fmlint delegates to the shared methods (output unchanged); pycustomlint
gains a linter_name for consistent reports. Update SPEC 4.3.1 and track
the mdoctor/python_ruff migration in todo.md.
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Wire PythonCustomLinter into run_sanity as the pycustomlint check
(imports directly from the customlinter package; MAX_WORKERS 4 -> 5)
- Use BaseLinter.format_violations_report so every sanity linter
(markdownlint, frontmatter_lint, pycustomlint) prints the same
TARGET/DEFINITIONS/FILE/SUMMARY format; align summary line order in
base.py with the fmlint and mdoctor reports
- Remove dead backward-compat shims (src/mdoctor/fmlint.py,
src/python_ruff/pycustomlint.py); nothing imported them
- Hoist all 45 inline imports in src to module level per the python-tdd
skill, fixing the one test mock that relied on the lazy import
- Sync SPEC: 4.2/4.4 covers, new 4.9.3 Linter Report Format section,
frontmatter version 0.27.9 -> 0.28.0
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
Per-file TOC (SPEC 4.8.2):
- toc-start markers record their params (sectionized, headings range);
on regeneration the marker params have priority, then CLI arguments,
then fiona-settings.json defaults; legacy bare markers are upgraded
- --sectionized forces section numbering on for the run
- folder TOC validates its target: a file or missing path exits 1 with
a hint toward 'librarian toc file'; empty folders are reported
- MD032-compliant TOC block layout (blank lines around the entry list)
- wiki root discovery skips build artifacts (build/, dist/, __pycache__/,
*.egg-info/) that shadowed the real settings with stale copies
Logging (SPEC 5.1):
- shared fiona.logging_config used by every CLI entry point; level from
LOG_LEVEL env > fiona.log_level > WARNING; physical-file logging via
fiona.file_log_level / fiona.file_log_location
- operational TOC logs promoted to INFO so file logs record activity
Docs:
- SPEC section references renumbered after sectionize (1.x/2.x/3.x ->
3.x/4.x/5.x) across code, tests, AGENTS.md, todo.md and the template
Generate an in-file table of contents below the H1 (SPEC 2.7.2):
- toc file <path> for one file, toc file * for the wiki root tree
- marker-delimited block regenerated in place, never duplicated
- optional section numbering written into headings so anchors resolve
- markdown.toc_generator.file settings: min_heading, max_heading,
sectionize, ignore_files, plus per-file glob overrides
- read-only zones (personal/, raw/) skipped in bulk, refused explicitly
- Remove custom activate-global-python-argcomplete check
- Always call argcomplete.autocomplete(parser) when argcomplete is available
- This enables tab completion for both pip install and editable mode
- Update README to clarify argcomplete is automatically available as a dependency
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Check if activate-global-python-argcomplete is available on system PATH
- If available, assume global completion is already set up via shell
- Otherwise, enable completion directly on this parser
- Graceful fallback if argcomplete is not installed
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Add argcomplete as a runtime dependency in pyproject.toml
- Enable argcomplete in __main__.py with proper error handling
- Users get tab completion automatically after pip install
- Completion works for all commands and flags dynamically
- Works for both Bash and Zsh
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Add fiona-assistant-completion.bash for tab completion support
- Add README.md documenting CLI usage and bash completion setup
- Completion supports all commands and subcommands
- Completion works for flags and directory/file arguments
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Add update_manager.py module with stub implementations for:
- File comparison (md files via frontmatter, others via SHA256)
- Settings file preservation during updates
- Update summary generation
- Add CLI commands: fiona-assistant wiki check-update and wiki update
- Add comprehensive test suite with 48 tests for update_manager
- Update SPEC.md with new command documentation
- Update todo.md to reflect partial implementation
- Achieve 96% test coverage (required for sanity)
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Add SPEC 2.9: json-lint (JSON Linter) with syntax validation, style rules,
CLI integration, and sanity integration
- Update todo.md with JSON linter implementation tasks
- Nest toc_generator settings under markdown in fiona-settings.json
- Update toc_generator loading in toc_generator.py to support both old and new paths
- Fix SPEC references to toc_generator -> markdown.toc_generator
- Fix line length violations in SPEC.md
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Add support for markdown.frontmatter.ignore_rules in fiona-settings.json
- Add support for markdown.frontmatter.ignore_file in fiona-settings.json
- Patterns like */AGENTS.md match files in any directory
- Update SPEC.md to document the new settings
- Filter violations based on ignore_rules
- Skip files matching ignore_file patterns
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Add frontmatter to files missing it (README.md, ingest/README.md, etc.)
- Add missing name/version fields to files with partial frontmatter
- Fix skill name in fiona/SKILL.md (FIONA-ASSISTANT -> fiona)
- Add description to python-tdd/SKILL.md
- Update run_sanity.py to only lint src/llm-wiki/ (per Rule 8)
- Frontmatter lint now passes with 0 violations
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Change respect_gitignore default from False to True
- .pytest_cache/README.md is now properly excluded from linting
- Frontmatter lint violations reduced from 25 to 22 in sanity check
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Break long lines in SPEC.md section 2.1.3.4 (SKILL.md Validation)
- Lines 521 and 523 were exceeding line length limit
- Now passes markdownlint check
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Remove descriptive messages from violation output (definitions section has them)
- Keep error details for FML001 (parse errors need the actual error)
- Keep context for FML006 (expected vs actual skill name)
- Output now shows just the code for most violations
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>