refactor: unify build commands by replacing analyze and index references with build and add knowcode_telemetry.jsonl to gitignore

Author: deepakdgupta1

.gitignore

@@ -206,6 +206,7 @@ __marimo__/
 
 # KnowCode generated files
 knowcode_knowledge.json
+knowcode_telemetry.jsonl
 CHANGELOG.md
 docs_test/
 #aimodels.yaml

src/knowcode/cli/cli.py

@@ -224,7 +224,7 @@ def query(query_type: str, target: str, store: str, as_json: bool) -> None:
     try:
         service = KnowCodeService(store_path=store)
     except FileNotFoundError:
-        click.echo("Error: Knowledge store not found. Run 'knowcode analyze' first.", err=True)
+        click.echo("Error: Knowledge store not found. Run 'knowcode build' first.", err=True)
         sys.exit(1)
 
     results: list[dict[str, Any]] = []
@@ -355,7 +355,7 @@ def context(target: str, store: str, max_tokens: int) -> None:
     try:
         service = KnowCodeService(store_path=store)
     except FileNotFoundError:
-        click.echo("Error: Knowledge store not found. Run 'knowcode analyze' first.", err=True)
+        click.echo("Error: Knowledge store not found. Run 'knowcode build' first.", err=True)
         sys.exit(1)
 
     try:
@@ -387,7 +387,7 @@ def export(store: str, output: str) -> None:
     try:
         service = KnowCodeService(store_path=store)
     except FileNotFoundError:
-        click.echo("Error: Knowledge store not found. Run 'knowcode analyze' first.", err=True)
+        click.echo("Error: Knowledge store not found. Run 'knowcode build' first.", err=True)
         sys.exit(1)
 
     output_dir = Path(output)
@@ -413,7 +413,7 @@ def stats(store: str) -> None:
     try:
         service = KnowCodeService(store_path=store)
     except FileNotFoundError:
-        click.echo("Error: Knowledge store not found. Run 'knowcode analyze' first.", err=True)
+        click.echo("Error: Knowledge store not found. Run 'knowcode build' first.", err=True)
         sys.exit(1)
 
     s = service.get_stats()
@@ -560,7 +560,7 @@ def history(target: Optional[str], store: str, limit: int) -> None:
     try:
         service = KnowCodeService(store_path=store)
     except FileNotFoundError:
-        click.echo("Error: Knowledge store not found. Run 'knowcode analyze' first.", err=True)
+        click.echo("Error: Knowledge store not found. Run 'knowcode build' first.", err=True)
         sys.exit(1)
 
     knowledge = service.store
@@ -708,7 +708,7 @@ def mcp_server(store: str, config: Optional[str]) -> None:
     store_file = store_path / KnowledgeStore.DEFAULT_FILENAME if store_path.is_dir() else store_path
     if not store_file.exists():
         click.echo(
-            "Error: Knowledge store not found. Run `knowcode analyze <dir>` first.",
+            "Error: Knowledge store not found. Run `knowcode build <dir>` first.",
             err=True,
         )
         sys.exit(1)

src/knowcode/doctor.py

@@ -216,7 +216,7 @@ def _check_knowledge_store(store_file: Path, checks: list[DoctorCheck]) -> None:
                 name="Knowledge store",
                 status="fail",
                 message=f"Knowledge store not found: {store_file}",
-                hint="Run `knowcode analyze <dir>` first.",
+                hint="Run `knowcode build <dir>` first.",
             )
         )
         return
@@ -230,7 +230,7 @@ def _check_knowledge_store(store_file: Path, checks: list[DoctorCheck]) -> None:
                 name="Knowledge store",
                 status="fail",
                 message=f"Could not load {store_file}: {exc}",
-                hint="Re-run `knowcode analyze <dir>` to rebuild the store.",
+                hint="Re-run `knowcode build <dir>` to rebuild the store.",
             )
         )
         return
@@ -245,7 +245,7 @@ def _check_knowledge_store(store_file: Path, checks: list[DoctorCheck]) -> None:
                     f"Loaded {store_file} via schema migration "
                     f"({len(store.entities)} entities)."
                 ),
-                hint="Re-run `knowcode analyze <dir>` to persist the current schema.",
+                hint="Re-run `knowcode build <dir>` to persist the current schema.",
             )
         )
         return
@@ -275,7 +275,7 @@ def _check_semantic_index(
                 name="Semantic index",
                 status="fail",
                 message=f"Semantic index not found: {index_path}",
-                hint="Run `knowcode index <dir>` first.",
+                hint="Run `knowcode build <dir>` first.",
             )
         )
         return
@@ -375,7 +375,7 @@ def _check_semantic_index(
                 name="Semantic index",
                 status="fail",
                 message=f"{index_path}: {'; '.join(failures)}.",
-                hint="Rebuild the semantic index with `knowcode index <dir>`.",
+                hint="Rebuild the semantic index with `knowcode build <dir>`.",
             )
         )
         return
@@ -720,7 +720,7 @@ def _check_freshness(store_path: str | Path, config_path: str | Path | None, che
                     name="Freshness",
                     status="warn",
                     message=f"Store/index may be stale. Reasons: {', '.join(freshness['stale_reasons'])}.",
-                    hint="Re-run `knowcode analyze` and `knowcode index` to rebuild artifacts.",
+                    hint="Re-run `knowcode build` to rebuild artifacts.",
                 )
             )
         else:

src/knowcode/errors.py

@@ -21,7 +21,7 @@ def __init__(self, store_file: Path) -> None:
         super().__init__(
             f"Knowledge store not found: {store_file}",
             code="missing_knowledge_store",
-            hint="Run `knowcode analyze <dir>` first.",
+            hint="Run `knowcode build <dir>` first.",
         )
 
 
@@ -32,5 +32,5 @@ def __init__(self, index_path: Path) -> None:
         super().__init__(
             f"Semantic index not found: {index_path}",
             code="missing_semantic_index",
-            hint="Run `knowcode index <dir>` first.",
+            hint="Run `knowcode build <dir>` first.",
         )

src/knowcode/indexing/indexer.py

@@ -219,7 +219,7 @@ def _validate_and_migrate_payload_schema(
                 if legacy_value not in allowed_legacy_values:
                     raise ValueError(
                         f"Unsupported legacy {payload_name} version "
-                        f"{legacy_value!r}. Rebuild with `knowcode index`."
+                        f"{legacy_value!r}. Rebuild with `knowcode build`."
                     )
             migrated = dict(payload)
             migrated["schema_version"] = cls.SCHEMA_VERSION
@@ -239,7 +239,7 @@ def _validate_and_migrate_payload_schema(
             f"Unsupported {payload_name} schema version "
             f"{schema_version!r}. Supported versions: "
             f"{sorted(cls.SUPPORTED_SCHEMA_VERSIONS)}. "
-            "Rebuild with `knowcode index`."
+            "Rebuild with `knowcode build`."
         )
 
     @staticmethod

src/knowcode/storage/knowledge_store.py

@@ -143,7 +143,7 @@ def _migrate_schema(cls, data: dict[str, Any]) -> dict[str, Any]:
                 return migrated
             raise ValueError(
                 "Unsupported legacy knowledge store format. "
-                f"Found version={legacy_version!r}. Re-run `knowcode analyze`."
+                f"Found version={legacy_version!r}. Re-run `knowcode build`."
             )
 
         normalized = cls._normalize_schema_version(schema_version)
@@ -160,7 +160,7 @@ def _migrate_schema(cls, data: dict[str, Any]) -> dict[str, Any]:
             "Unsupported knowledge store schema version "
             f"{schema_version!r}. Supported versions: "
             f"{sorted(cls.SUPPORTED_SCHEMA_VERSIONS)}. "
-            "Re-run `knowcode analyze` to rebuild persisted artifacts."
+            "Re-run `knowcode build` to rebuild persisted artifacts."
         )
 
     @staticmethod

src/knowcode/storage/vector_store.py

@@ -199,7 +199,7 @@ def _validate_and_migrate_metadata(cls, data: dict[str, Any]) -> dict[str, Any]:
             "Unsupported vector index schema version "
             f"{schema_version!r}. Supported versions: "
             f"{sorted(cls.SUPPORTED_SCHEMA_VERSIONS)}. "
-            "Rebuild with `knowcode index`."
+            "Rebuild with `knowcode build`."
         )
 
     @staticmethod

tests/unit/cli/test_doctor.py

@@ -138,8 +138,8 @@ def test_doctor_reports_missing_store_and_index(tmp_path: Path) -> None:
     failed = {check["name"]: check for check in payload["checks"] if check["status"] == "fail"}
     assert "Knowledge store" in failed
     assert "Semantic index" in failed
-    assert "knowcode analyze" in failed["Knowledge store"]["hint"]
-    assert "knowcode index" in failed["Semantic index"]["hint"]
+    assert "knowcode build" in failed["Knowledge store"]["hint"]
+    assert "knowcode build" in failed["Semantic index"]["hint"]
 
 
 def test_doctor_fails_on_index_dimension_mismatch(tmp_path: Path) -> None:

tests/unit/mcp/test_mcp_server_tools.py

@@ -206,7 +206,7 @@ def test_handle_tool_call_reports_missing_prerequisites(tmp_path: Path) -> None:
     result = json.loads(server.handle_tool_call("search_codebase", {"query": "Foo"}))
 
     assert result["code"] == "missing_knowledge_store"
-    assert "knowcode analyze" in result["hint"]
+    assert "knowcode build" in result["hint"]
 
 
 def test_mcp_server_initializes_service_with_strict_config(

tests/unit/service/test_retrieve_context_for_query.py

@@ -167,7 +167,7 @@ def test_retrieve_context_raises_when_store_missing(tmp_path: Path) -> None:
     with pytest.raises(MissingKnowledgeStoreError) as exc:
         service.retrieve_context_for_query("Explain e1", verbosity="diagnostic")
     assert exc.value.code == "missing_knowledge_store"
-    assert "knowcode analyze" in exc.value.hint
+    assert "knowcode build" in exc.value.hint
 
 
 def test_retrieve_context_raises_when_index_missing(tmp_path: Path) -> None:
@@ -177,7 +177,7 @@ def test_retrieve_context_raises_when_index_missing(tmp_path: Path) -> None:
     with pytest.raises(MissingSemanticIndexError) as exc:
         service.retrieve_context_for_query("Explain e1", verbosity="diagnostic")
     assert exc.value.code == "missing_semantic_index"
-    assert "knowcode index" in exc.value.hint
+    assert "knowcode build" in exc.value.hint
 
 
 def test_ensure_store_builds_only_when_missing(tmp_path: Path) -> None: