@pmaddire/gcie 0.1.9 → 0.1.11

package/GCIE_USAGE.md

@@ -38,8 +38,13 @@ gcie.cmd adaptive-profile . --clear
 ```
 
 Post-init adaptation pipeline:
+- run from the target repo root (cd <repo> first); use . as scope
+- adaptation now bootstraps per-family method defaults before accuracy rounds (plain/plain-gapfill/plain-rescue/slices)
+- adaptation case generation is mixed by design (single-file, same-layer pairs, cross-subtree pairs, and some 3-file chains on larger runs)
 ```powershell
 gcie.cmd adapt . --benchmark-size 10 --efficiency-iterations 5 --clear-profile
+# mixed-layer repos: use wider calibration
+gcie.cmd adapt . --benchmark-size 25 --efficiency-iterations 5 --clear-profile
 ```
 
 One-shot setup + adaptation:
@@ -148,7 +153,7 @@ When retrieval is weak, apply in this exact order:
 1. Query upgrade: add explicit files, symbols, caller/entry anchor
 2. Scope correction: subtree vs root
 3. One profile/budget escalation
-4. Targeted gap-fill for only missing must-have file(s)
+4. Targeted gap-fill for only missing must-have file(s), preferring direct file-path scope first
 5. Multi-hop decomposition only if still incomplete
 
 Stop condition:
@@ -189,6 +194,29 @@ gcie.cmd index .
 - Proceed to calibration only after coverage is reachable with stable behavior.
 - If not reachable, keep safer fallback mode for affected families and continue tracking.
 
+## Calibration Quality Gate (Cross-Repo, Required)
+
+Before accepting adaptation results, verify calibration quality:
+
+1. Family diversity floor:
+- the generated benchmark set should cover at least 3 task families when the repo has multiple top-level subsystems
+- if adaptation output is dominated by only `single_file` and `same_layer_pair`, treat it as underfit
+
+2. Underfit recovery:
+- rerun adaptation with wider calibration
+```powershell
+gcie.cmd adapt . --benchmark-size 25 --efficiency-iterations 5 --clear-profile
+```
+- keep `benchmark-size 10` only for small/single-layer repos or quick smoke checks
+
+3. Accuracy-first acceptance:
+- do not accept a profile below `100%` full-hit if a recoverable path exists
+- run one rescue cycle (query upgrade -> scope correction -> one budget/profile rung -> targeted gap-fill)
+- only then finalize family defaults
+
+4. Cost lock sanity:
+- if selected profile is much more expensive than cheapest (`>40%` token delta), keep status as cost-risk and continue family-level refinement
+- do not freeze expensive global defaults unless they are uniquely required for `100%`
 ## Automatic Post-Trigger Adaptation (Required)
 
 After trigger detection in a repo session:
@@ -338,8 +366,37 @@ After running adaptation:
 Commands:
 ```powershell
 gcie.cmd adapt . --benchmark-size 10 --efficiency-iterations 5 --clear-profile
+# mixed-layer repos: use wider calibration
+gcie.cmd adapt . --benchmark-size 25 --efficiency-iterations 5 --clear-profile
 ```
 ```powershell
 gcie.cmd adapt . --benchmark-size 10 --efficiency-iterations 5
 ```
 
+
+## Remove GCIE From A Repo
+
+To remove GCIE-managed files from the current repo:
+
+```powershell
+gcie.cmd remove .
+```
+
+Options:
+- keep `GCIE_USAGE.md`: `--keep-usage`
+- keep `SETUP_ANY_REPO.md`: `--keep-setup-doc`
+- also remove `.planning` artifacts: `--remove-planning`
+
+Example:
+
+```powershell
+gcie.cmd remove . --remove-planning
+```
+
+
+
+
+
+
+
+

package/cli/app.py

@@ -14,7 +14,7 @@ from .commands.context_slices import adaptive_profile_summary, clear_adaptive_pr
 from .commands.debug import run_debug
 from .commands.index import run_index
 from .commands.query import run_query
-from .commands.setup import run_setup
+from .commands.setup import run_remove, run_setup
 
 app = typer.Typer(help="GraphCode Intelligence Engine CLI")
 
@@ -177,6 +177,21 @@ def setup_cmd(
     typer.echo(json.dumps(result, indent=2))
 
 
+@app.command("remove")
+def remove_cmd(
+    path: str = typer.Argument("."),
+    remove_planning: bool = typer.Option(False, "--remove-planning", help="Also remove .planning artifacts"),
+    keep_usage: bool = typer.Option(False, "--keep-usage", help="Keep GCIE_USAGE.md in place"),
+    keep_setup_doc: bool = typer.Option(False, "--keep-setup-doc", help="Keep SETUP_ANY_REPO.md in place"),
+) -> None:
+    result = run_remove(
+        path,
+        remove_planning=remove_planning,
+        remove_gcie_usage=not keep_usage,
+        remove_setup_doc=not keep_setup_doc,
+    )
+    typer.echo(json.dumps(result, indent=2))
+
 @app.command("cache-clear")
 def cache_clear_cmd(path: str = typer.Argument(".")) -> None:
     result = clear_cache(path)
@@ -197,3 +212,5 @@ def cache_warm_cmd(path: str = typer.Argument(".")) -> None:
 
 if __name__ == "__main__":
     app()
+
+