Function paperAudit

paperAudit(
vault: Vault,
args: { folder?: string; limit?: number; tag?: string },
): Promise<{ flagged: PaperAuditFinding[]; scanned: number }>
Audit #paper-tagged notes for missing citation metadata.

Scans every note carrying the configured tag and verifies frontmatter has at least one of arxiv / doi / url / isbn. Notes with detectable identifiers in body text (e.g. arxiv:2401.12345 from quick-capture) but missing frontmatter receive an actionable proposed_frontmatter_patch.
Parameters
- vault: Vault
  The vault.
- args: { folder?: string; limit?: number; tag?: string }
  All optional. tag defaults to "paper" (leading # stripped if provided). folder restricts the scan. limit defaults to 100.
Returns Promise<{ flagged: PaperAuditFinding[]; scanned: number }>
{ scanned, flagged } — scanned counts notes carrying the tag; flagged is the subset with missing frontmatter citation.
Throws
If folder resolves outside the vault.
Example
```
const audit = await paperAudit(vault, { tag: "paper", limit: 50 });
console.log(`${audit.flagged.length}/${audit.scanned} papers need citation`);
for (const p of audit.flagged) {
  if (p.proposed_frontmatter_patch) {
    await frontmatterSet(vault, { path: p.path, set: p.proposed_frontmatter_patch });
  }
}
```
- Defined in tools/meta.ts:702