Change docs.json to mint.json for multi docs

[oshorefueled]

Summary by CodeRabbit

• New Features

  • Added "Agentic Content Review" skill for automated content quality checks against configurable markdown rules.
  • Included three default quality rules: Directness, Unsupported Claims, and AI Patterns.
  • New command-line tools for managing active rules and scoring review results.

• Chores

  • Updated version to 2.5.1.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

Introduces an agentic content review skill for markdown content validation using .vlint rules. Includes skill documentation, agent configuration, reviewer directives, rule specifications (Directness, AI Patterns, Unsupported Claims), CLI scripts for rule discovery and review scoring, and comprehensive test coverage.

Changes

Cohort / File(s)	Summary
Agentic Content Review Skill .codex/skills/agentic-content-review/SKILL.md, .codex/skills/agentic-content-review/agents/openai.yaml	Defines skill specification for agent-native content review workflow with delegation of subagents per rule per source file, specifies parsing and density scoring validation, and establishes output structure standards.
Reference Documentation .codex/skills/agentic-content-review/references/*	Establishes templates and specifications for finding output format, reviewer directives, rule index schema, and subagent adapter contracts to standardize content review operations.
Default Content Review Rules .codex/skills/agentic-content-review/rules/default/*	Introduces three markdown content quality rules (Directness, AI Patterns, Unsupported Claims) and their rule index with active flags and path mappings.
CLI Scripts .codex/skills/agentic-content-review/scripts/list-active-rules.ts, .codex/skills/agentic-content-review/scripts/parse-review-and-score.ts	Adds rule discovery script that resolves active rules from workspace and default indexes, and parsing/scoring script that validates findings against templates, computes density-based scores (0–10), and generates session logs.
Tests & Build Configuration tests/evaluations/parse-review-and-score.test.ts, package.json	Adds comprehensive unit and integration test suite for parsing/scoring utilities and build hooks; bumps version to 2.5.1.

Sequence Diagram

sequenceDiagram
    actor Caller
    participant System as Content Review System
    participant RuleDiscovery as Rule Discovery
    participant SubagentMgr as Subagent Manager
    participant Subagent as Reviewer Subagent
    participant Parser as Parser & Scorer
    participant Logger as Session Logger

    Caller->>System: Invoke agentic-content-review
    System->>RuleDiscovery: List active rules from .vlint/rules
    RuleDiscovery-->>System: [Rule1, Rule2, Rule3...]
    
    loop For each (SourceFile, Rule) pair
        System->>SubagentMgr: Dispatch subagent
        SubagentMgr->>Subagent: Process rule against source file
        Subagent->>Subagent: Read source & rule files<br/>Generate findings
        Subagent-->>SubagentMgr: Markdown findings report
    end
    
    System->>Parser: Parse & validate all findings
    Parser->>Parser: Validate against finding-template<br/>Compute density score
    Parser->>Logger: Build session log
    Logger-->>Logger: Resolve rule names, write JSON
    
    Parser-->>System: Scored report with findings<br/>& validation metadata
    System-->>Caller: Structured review output

Loading

Estimated Code Review Effort

🎯 3 (Moderate) | ⏱️ ~28 minutes

Possibly Related PRs

• feat: implement content chunking and dedicated scoring logic for evaluators #39: Overlaps on density-based scoring (0–10 clamped), violation merging, and word-counting logic implemented in parse-review-and-score.ts.
• feat: improve Issue Location Accuracy with Line Numbering and Fuzzy Matching #46: Shares finding/violation schema validation and quote-location handling (quoted_text, line, context fields) with the new parsing/validation code.
• Add Agent Mode #79: Both PRs address rule resolution and rule-index discovery surfaces used by agent tooling and agentic CLI scripts.

Suggested Reviewers

• ayo6706

Poem

🐰 Hop, hop, review the prose with care,
Where rules dance light through markdown air,
Each finding scored from 0 to 10,
Agent subagents check again and again! 📋✨
New skills bloom—directness, claims, and AI patterns fair!

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name	Status	Explanation	Resolution
Title check	⚠️ Warning	The pull request title references changing 'docs.json to mint.json for multi docs', but the actual changes introduce a new agentic-content-review skill with multiple configuration files, rule templates, TypeScript scripts, tests, and a version bump.	Update the title to reflect the actual changes, such as 'Add agentic-content-review skill with default rules and CLI scripts' or similar, to accurately represent the pull request content.
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/mint-file

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}