266 Commits

Author SHA1 Message Date
nvaldez 9c2fb71d2f fix: filter external URLs and fragments from wiki graph links
- 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>
2026-09-28 12:08:15 +02:00
nvaldez 5c8a56f81e feat: implement wiki graph Phase 1 - link parser, graph builder, HTML/JSON output
- Add src/wiki/graph_generator.py with MarkdownLinkParser, WikiGraph, HTMLGraphRenderer
- Add src/tests/test_graph_generator.py with 22 TDD tests
- Integrate graph subcommand into fiona-assistant wiki CLI
- Update SPEC.md with Phase 1 implementation, Phase 3-4 as NOT_IMPLEMENTED
- Add external links handling feature to SPEC

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-28 12:02:12 +02:00
nvaldez 9b624c5c3a docs: add wiki graph spec (SPEC 3.1.4)
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>
2026-09-28 11:44:47 +02:00
nvaldez 5a7d142ae6 bump tag 2026-09-28 11:26:56 +02:00
nvaldez 06b6798821 docs: mark 79 unimplemented requirements as NOT IMPLEMENTED in SPEC.md
Audit complete - all requirements that are not yet implemented have been
marked with the 'NOT IMPLEMENTED' tag following the pattern:
- *<number>.* `NOT IMPLEMENTED` <requirement>

Sections updated:
- 3.2 (Git Version Control): 4 reqs
- 3.2.1 (Backup Script): 3 reqs
- 4.2 (Frontmatter Linter): 16 reqs
- 4.6 (Shellcheck): 3 reqs
- 4.7 (MD Code Block Linting): 3 reqs
- 4.8.1 (Non-MD File Support): 2 items
- 4.10 (json-lint): 19 reqs
- 4.11 (Wiki Root Discovery + settings_manager): 20 reqs
- 5.1 (Logging): 3 reqs
- 5.2 (Documentation): 3 reqs
- 5.3 (Project Clarification): 3 reqs

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-28 11:24:26 +02:00
nvaldez 0359ae116d docs: document section convention and setuptools hack for llm-wiki
- Add Section Convention documentation to SPEC.md HTML comment
  describing heading levels, section structure, and TOC auto-generation
- Document the hyphenated, non-importable llm-wiki package in pyproject.toml
  setuptools configuration comments
- Update todo.md to mark documentation task as complete

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-28 11:10:13 +02:00
nvaldez fa194e4632 bump version 2026-09-28 10:48:36 +02:00
nvaldez d816c153f2 bump version 2026-09-28 10:47:07 +02:00
nvaldez 0a24ab79df fix: resolve all sanity failures in SPEC.md
- Fix 233 MD013 line length violations by wrapping long lines at natural
  breaking points (spaces, punctuation, markdown links)
- Fix 2 MD009 trailing space violations
- Fix 1 MD027 blockquote formatting violation
- All sanity checks now pass (pytests, coverage, markdownlint, ruff,
  frontmatter_lint, pycustomlint)

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-28 10:41:20 +02:00
nvaldez 417c1cf665 feat: add progress display and --non-interactive to wiki sanity
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>
2026-09-28 09:46:32 +02:00
nvaldez 4843ca5a9a feat: live per-check progress bars for run_sanity
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>
2026-09-27 23:00:03 +02:00
nvaldez 865d9f7f4e feat: add wiki sanity suite on shared sanity runner engine
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>
2026-09-27 22:48:25 +02:00
nvaldez 3f58fc283f bump version 2026-09-27 21:18:35 +02:00
nvaldez eca319c41a feat: implement wiki update per SPEC 3.1.2
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>
2026-09-27 21:16:01 +02:00
nvaldez 27b2b04d51 feat: name conflicting llm-wiki indicators in wiki init refusal
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>
2026-09-27 21:08:15 +02:00
nvaldez 024ccf9a82 feat: wiki init honors fiona.llm-wiki.ignore_files
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>
2026-09-27 21:02:39 +02:00
nvaldez f2c774429c refactor: consolidate conftest into src/tests/conftest.py
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>
2026-09-27 20:55:20 +02:00
nvaldez d47a8b404a feat: add per-check and total run timing to sanity runner
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>
2026-09-27 20:46:26 +02:00
nvaldez 4d1dd76c57 refactor: generalize compressed violations format in BaseLinter
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>
2026-09-27 20:35:11 +02:00
nvaldez 0dedc45e71 feat: add pycustomlint check to sanity runner with unified linter report
- 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>
2026-09-27 20:28:07 +02:00
nvaldez 8cd96b7210 added custom pylinting 2026-09-27 20:08:55 +02:00
nvaldez 3b6342f37a added how to fix the pytest in todo 2026-09-26 23:46:01 +02:00
nvaldez 9fa4dc844d added commit rule 2026-09-26 23:30:37 +02:00
nvaldez 031685fa5e sanity skill fix 2026-09-26 23:23:58 +02:00
nvaldez 6055ac64d8 Revert "single conftest implemented"
This reverts commit a72db94cdd.
2026-09-26 23:21:39 +02:00
nvaldez a72db94cdd single conftest implemented 2026-09-26 23:09:12 +02:00
nvaldez e29507e3fb fix agent rule 2026-09-26 22:55:46 +02:00
nvaldez 737f1f7094 restore the python-tdd skill 2026-09-26 22:51:13 +02:00
nvaldez 725136fecf updated docs 2026-09-26 19:44:09 +02:00
nvaldez 2bbfed67ae docs: match AGENTS.md structure diagram to reality, schema.md as structure source of truth 2026-09-26 19:03:24 +02:00
nvaldez 9a88619e3d feat: per-file TOC marker priority, --sectionized flag, project-wide logging
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
2026-09-26 18:47:06 +02:00
nvaldez 13467cfa2a feat: add per-file TOC generation (librarian toc file)
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
2026-09-26 11:48:12 +02:00
nvaldez 95771610d7 chore: move pylint to runtime dependencies
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-26 11:16:48 +02:00
nvaldez 30346828af docs: reconcile frontmatter schema and sectionize agent rules
- Frontmatter schema reconciled: name/version required, title optional,
  toc added to allowed types (SPEC 2.1.3.1, project agent rule 10.1)
- AGENTS.md rules renumbered into sections with project agent rule N.M
  references; llm-wiki AGENTS.md sectionized the same way
- Frontmatter stamped on template READMEs (personal/, raw/)

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-26 11:16:44 +02:00
nvaldez 72a3d7e4ea fix pypi packaging 2026-09-25 22:42:14 +02:00
nvaldez d0b3f1123c Revert to d085193 - remove autocompletion commits
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-25 10:42:09 +02:00
nvaldez 28c1c9c53c fix: enable argcomplete autocomplete for all pip install modes
- 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>
2026-09-25 10:12:34 +02:00
nvaldez 7223cc485c feat: check for activate-global-python-argcomplete on PATH
- 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>
2026-09-24 23:41:11 +02:00
nvaldez a961df13f0 feat: add argcomplete for automatic tab completion
- 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>
2026-09-24 23:33:49 +02:00
nvaldez c10fe191f9 docs: update README with modern argparse completion instructions
- Document argcomplete-based completion for Bash and Zsh
- Document native argparse completion for Python 3.11+
- Include development environment completion setup
- Add __init__.py for fiona package
- Remove manual completion script (replaced with argparse native)

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-24 23:31:22 +02:00
nvaldez d49229de3a docs: add bash completion script and CLI README
- 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>
2026-09-24 23:29:17 +02:00
nvaldez d0851933ee feat: add wiki check-update and update commands
- 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>
2026-09-24 23:21:11 +02:00
nvaldez c494aa1432 setting manager added in spec 2026-09-24 22:57:32 +02:00
nvaldez 998d55a663 feat: add JSON linter spec and nest toc_generator under markdown
- 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>
2026-09-24 22:49:06 +02:00
nvaldez ce14d8b1ba feat: add ignore_rules and ignore_file settings for frontmatter linter
- 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>
2026-09-24 22:38:51 +02:00
nvaldez 55a84af0ed fix: resolve MD012 multiple blank lines violations
- Fix consecutive blank lines in table_of_contents.md
- Fix consecutive blank lines in fiona/SKILL.md
- Fix consecutive blank lines in llm-wiki-mod.md
- Fix consecutive blank lines in python-tdd/SKILL.md
- Fix consecutive blank lines in wiki/schema.md
- Markdownlint now passes with 0 violations

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-24 22:34:12 +02:00
nvaldez 5ee4aa869e fix: add frontmatter to all llm-wiki markdown files
- 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>
2026-09-24 22:31:34 +02:00
nvaldez f819dc1e50 fix: respect .gitignore by default in FrontmatterLinter
- 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>
2026-09-24 22:25:15 +02:00
nvaldez a872f57935 fix: resolve MD013 line-length violations in SPEC.md
- 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>
2026-09-24 22:21:35 +02:00
nvaldez c75fef1722 refactor: simplify violation messages to just codes where definitions exist
- 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>
2026-09-24 22:16:10 +02:00