housekeep:Backing up local updates to cloud via GitHub for development to continue from another machine

Author: deepakdgupta1

README.md

@@ -140,6 +140,17 @@ Show statistics about the knowledge store.
 knowcode stats [--store <path>]
 ```
 
+### `doctor`
+Check whether the local KnowCode setup is ready for daily use.
+
+```bash
+knowcode doctor [--store <path>] [--index <path>] [--config <path>] [--mcp] [--json]
+```
+
+Checks include strict config loading, required model API keys, knowledge store
+schema, semantic index schema/embedding dimensions, artifact disk footprint,
+and optionally an MCP stdio handshake.
+
 ### `index`
 Build a semantic search index for your codebase.
 

docs/index.md

@@ -126,6 +126,17 @@ Show statistics about the knowledge store.
 knowcode stats [--store <path>]
 ```
 
+### `doctor`
+Check whether the local KnowCode setup is ready for daily use.
+
+```bash
+knowcode doctor [--store <path>] [--index <path>] [--config <path>] [--mcp] [--json]
+```
+
+Checks include strict config loading, required model API keys, knowledge store
+schema, semantic index schema/embedding dimensions, artifact disk footprint,
+and optionally an MCP stdio handshake.
+
 ### `index`
 Build a semantic search index for your codebase.
 

src/knowcode/cli/cli.py

@@ -373,6 +373,74 @@ def stats(store: str) -> None:
         click.echo(f"  {kind}: {count}")
 
 
+@cli.command()
+@click.option(
+    "--store", "-s",
+    type=click.Path(),
+    default=".",
+    help="Path to knowledge store file or directory",
+)
+@click.option(
+    "--index", "-i",
+    "index_path",
+    type=click.Path(),
+    help="Path to semantic index directory (default: beside the store)",
+)
+@click.option(
+    "--config", "-c",
+    type=click.Path(),
+    help="Path to configuration file (aimodels.yaml)",
+)
+@click.option(
+    "--max-disk-mb",
+    type=float,
+    default=500.0,
+    show_default=True,
+    help="Warn if KnowCode artifacts exceed this size.",
+)
+@click.option(
+    "--mcp/--no-mcp",
+    default=False,
+    help="Spawn the MCP server and verify list_tools plus one tool call.",
+)
+@click.option(
+    "--json", "as_json",
+    is_flag=True,
+    help="Output the doctor report as JSON.",
+)
+def doctor(
+    store: str,
+    index_path: Optional[str],
+    config: Optional[str],
+    max_disk_mb: float,
+    mcp: bool,
+    as_json: bool,
+) -> None:
+    """Check whether the local KnowCode setup is ready."""
+    from knowcode.doctor import run_doctor
+
+    report = run_doctor(
+        store_path=store,
+        index_path=index_path,
+        config_path=config,
+        max_disk_mb=max_disk_mb,
+        include_mcp=mcp,
+    )
+
+    if as_json:
+        click.echo(json.dumps(report.to_dict(), indent=2))
+    else:
+        click.echo("KnowCode Doctor")
+        click.echo("-" * 30)
+        for check in report.checks:
+            click.echo(f"[{check.status.upper()}] {check.name}: {check.message}")
+            if check.hint:
+                click.echo(f"       Hint: {check.hint}")
+
+    if not report.ok:
+        sys.exit(1)
+
+
 @cli.command()
 @click.option(
     "--store", "-s",

src/knowcode/config.py

@@ -30,6 +30,7 @@ class AppConfig:
         "natural_language_models",
         "embedding_models",
         "reranking_models",
+        "eval_models",
         "config",
     }
     KNOWN_CONFIG_KEYS = {"sufficiency_threshold"}