naga

Cross-repo pattern replication. Reads a source artifact in one repository tree and generates a matched-form artifact in another, resolving paths via the sibling-repo convention (<repo-root>/<sibling>/...). Runs N1+N2+N3+N4 with N5 threshold gating; escalates to naga-orchestrator when source and target domains diverge. Use when the user runs /naga:match-across or asks to propagate a pattern from repo A to repo B. Do not use for same-repo replication (see /naga:match).

Read-only pattern report via N2 Spaerck Jones TF-IDF and N3 Levenshtein naming-convention scan. Returns the top-N stylistic terms and the naming convention distribution; performs no generation and writes no state outside the report. Use when the user runs /naga:fingerprint or asks "what pattern does this file follow?" without intending to replicate it. Do not use for fingerprint persistence (see /naga:observe) or for generation (see /naga:match).

Generates a target artifact whose N4 cosine fidelity to the source fingerprint clears the per-(pattern-class, target-domain) p10 threshold from the N5 posterior. Loop: emit chunk, score, rewrite below threshold (cap 2 attempts), drop on third. Use when the user runs /naga:match or asks to generate a new artifact in the same shape as an existing one. Do not use for fingerprint-only reports (see /naga:fingerprint) or for cross-repo work (see /naga:match-across).

Scores fidelity of a generated artifact against a source pattern via N1 Zhang-Shasha tree-edit + N4 Salton-Wong-Yang cosine. Returns (score, ci_low, ci_high, N) per the honest-numbers contract. Use when the user runs /naga:validate or asks "how close is this to the source pattern?". Do not use for fingerprinting (see /naga:observe) or for generation (see /naga:match).

Extracts the pattern fingerprint from a source artifact via N1 Zhang-Shasha AST tree-edit signature and N2 Spaerck Jones TF-IDF over identifier, comment, and structure tokens. Persists the fingerprint to plugins/naga-observe/state/ patterns/<hash>.json. Use when the user runs /naga:observe or asks to capture the structural and stylistic shape of an existing file. Do not use for generation (see /naga:match) or for cross-domain replication (see /naga:match-across).