diff --git a/README.md b/README.md index a4a5e95..e376578 100644 --- a/README.md +++ b/README.md @@ -183,6 +183,8 @@ Quale provides structural context that helps agents make better decisions about quale o # Orient: repo map + landmarks quale ec --files # Edit context: risk + verification candidates quale vp --files # Verify packet: co-change signal + quale risk --mode co-change # Co-change prediction: what else to read + quale verify --mode incomplete --files # Detects if a change is incomplete ``` **What agents get**: @@ -215,6 +217,9 @@ See [docs/EFFECT_HARNESS.md](docs/EFFECT_HARNESS.md) for full methodology. | `quale ci check ` | Runs structural gates, exits 0-7 with bitmask | | `quale ci comment ` | Posts structural report as GitHub PR comment | | `quale ci trend` | Tracks CI metric trends over time | +| `quale risk --mode co-change` | Co-change prediction: what files change together (PMI × git) | +| `quale risk --mode anomaly` | Finds identifiers with unusually high PMI (hidden coupling) | +| `quale verify --mode incomplete` | Detects files missing from a change set (incomplete PRs) | ### Advanced primitives diff --git a/docs/COMMANDS.md b/docs/COMMANDS.md index 5298a18..58a5ac1 100644 --- a/docs/COMMANDS.md +++ b/docs/COMMANDS.md @@ -77,11 +77,14 @@ These replace multiple old commands with single, mode-switched interfaces. quale risk # Hub + capillary + vulnerability intersection quale risk --mode hub # Hub risk only quale risk --mode capillary # Capillary risk only +quale risk --mode co-change # Co-change prediction: PMI × git history (agent workflow) +quale risk --mode anomaly # PMI outlier detection: identifier pairs with unusual coupling quale verify --files src/auth.ts # Combined verification: mc, scope, packet quale verify --mode mc # Pre-edit multi-choice verification (75% accuracy) quale verify --mode packet # Post-edit co-change signal (80% accuracy) quale verify --mode scope # Post-edit scope verification (83% accuracy) +quale verify --mode incomplete # Incomplete change detection: flags missing co-change partners quale health # Structural health dashboard quale health --mode score # Single health score diff --git a/docs/FEATURE_MATRIX.md b/docs/FEATURE_MATRIX.md index dd94ca3..69acef3 100644 --- a/docs/FEATURE_MATRIX.md +++ b/docs/FEATURE_MATRIX.md @@ -18,8 +18,8 @@ These replace multiple old commands with single, mode-switched interfaces. | Command | Replaces | Description | |---------|----------|-------------| -| `quale risk` | `hub-risk`, `capillary`, `vulnerability-map`, `traffic-control` | Surface risky files: hub, capillary, and their intersection. Modes: `--mode full` (default), `hub`, `capillary` | -| `quale verify` | `verify-packet`, `verify-scope`, `verify-classify`, `verify-bonds`, `verify-drift`, `guard` | Verification pipeline. Modes: `--mode full` (default), `mc`, `scope`, `packet` | +| `quale risk` | `hub-risk`, `capillary`, `vulnerability-map`, `traffic-control` | Surface risky files: hub, capillary, and their intersection. Modes: `--mode full` (default), `hub`, `capillary`, `co-change` (PMI × git prediction), `anomaly` (PMI outlier detection) | +| `quale verify` | `verify-packet`, `verify-scope`, `verify-classify`, `verify-bonds`, `verify-drift`, `guard` | Verification pipeline. Modes: `--mode full` (default), `mc`, `scope`, `packet`, `incomplete` (flags missing co-change partners) | | `quale health` | `health-score`, `drift-check`, `parity-bit` | Structural health dashboard. Modes: `--mode dashboard` (default), `score` | | `quale audit` | `ci-report`, `pr-report`, `check-diff`, `check-pr` | Review a diff: structural, CI, and PR reports in one command | | `quale temporal` | `decay`, `vocabulary-trend`, `origins` | Temporal analysis: decay, vocabulary trends, and phrase lifecycles |