Skip to content

score: 102 broken ADF path references on charter repo — path resolver doesn't handle monorepo layouts or absolute Windows paths #163

@stackbilt-admin

Description

@stackbilt-admin

Problem

charter score on the charter repo reports:

[warn] Grounding  12/20  31/133 referenced paths resolve; 34/37 code-block commands look runnable; 102 broken reference(s)

The broken references include:

  • stackbilt_llc/policies/oss-infrastructure-update-policy.md — cross-repo reference (no local copy)
  • Files/Git/mingw64/bin/git-credential-manager.exe — Windows absolute path from git config
  • .cursorrules — file intentionally absent (not all repos use Cursor)

Issues

  1. Cross-repo references: ADF files legitimately reference paths in sibling repos. The path resolver should skip or flag-differently references that look like <repo-name>/path (no leading ./) — these can't resolve locally by design.

  2. Absolute OS paths: Windows/system paths that leak into git config or tool output shouldn't count as broken ADF references. Filter references that contain OS path separators outside project root.

  3. Known-absent files: If a reference is to a file that charter's own score check recommends adding (.cursorrules, AGENTS.md), it shouldn't count as a broken reference — it should count as a missing-recommended-file warning instead. Double-counting inflates the broken count.

Expected

The grounding score should reflect references to files that should exist but don't — not cross-repo links or system paths that are correct by design. Target: genuine broken references should drop from 102 to <10 after these filters.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions