core-cli 1.0.0__py3-none-any.whl

core_cli/resources/vectors/rebuild.py

@@ -0,0 +1,71 @@
+# src/core_cli/resources/vectors/rebuild.py
+
+"""Rebuild a Qdrant collection — consumer CLI over HTTP (ADR-146 D2).
+
+A real rebuild is three coordinated operations (per #203):
+  1. Delete the Qdrant collection.
+  2. Reset core.repo_artifacts.chunk_count = 0 for targeted rows.
+  3. RepoEmbedderWorker repopulates organically on its next cycle.
+
+The CORE API route handles all three; this file is the thin CLI surface.
+"""
+
+from __future__ import annotations
+
+import typer
+from rich.console import Console
+
+from api.cli import CoreApiClient
+from cli.utils import core_command
+
+from .hub import app
+
+
+console = Console()
+
+
+@app.command("rebuild")
+@core_command(dangerous=True, requires_context=False)
+# ID: f0398939-3c90-4972-b8bf-1241dcc6b732
+async def rebuild_collection(
+    ctx: typer.Context,
+    collection: str = typer.Option(
+        ...,
+        "--collection",
+        "-c",
+        help="Qdrant collection to rebuild (e.g. core-code, core-specs).",
+    ),
+    write: bool = typer.Option(
+        False, "--write", help="Apply the rebuild (default: dry-run)."
+    ),
+) -> None:
+    """Delete a Qdrant collection and reset chunk_count so it repopulates.
+
+    Dry-run by default — shows how many artifacts would be re-embedded.
+    Pass --write to delete the collection and reset chunk_count.
+    """
+    client = CoreApiClient()
+    try:
+        result = await client.vectors.rebuild(collection, write=write)
+    except Exception as exc:
+        console.print(f"[red]Error: {exc}[/red]")
+        raise typer.Exit(1) from exc
+
+    if not write:
+        total = result.get("artifacts_total", 0)
+        reset = result.get("artifacts_to_reset", 0)
+        console.print(f"[bold cyan]Vector rebuild — {collection}[/bold cyan]")
+        console.print(f"Artifacts targeting collection: {total} (embedded: {reset})")
+        console.print(
+            f"[yellow]DRY-RUN:[/yellow] would delete '{collection}' and reset "
+            f"chunk_count=0 on {reset} artifact(s). Use --write to apply."
+        )
+    else:
+        reset = result.get("artifacts_reset", 0)
+        console.print(f"[green]Deleted[/green] Qdrant collection '{collection}'.")
+        console.print(
+            f"[green]Reset[/green] chunk_count=0 on {reset} artifact(s)."
+        )
+        console.print(
+            "[dim]RepoEmbedderWorker will recreate the collection on its next cycle.[/dim]"
+        )

core_cli/resources/vectors/status.py

@@ -0,0 +1,40 @@
+# src/core_cli/resources/vectors/status.py
+
+"""Vector store status command — consumer CLI over HTTP (ADR-146 D2)."""
+
+from __future__ import annotations
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from api.cli import CoreApiClient
+from cli.utils import core_command
+
+from .hub import app
+
+
+console = Console()
+
+
+@app.command("status")
+@core_command(dangerous=False, requires_context=False)
+# ID: 61334967-75a9-4a0a-96aa-00e53698b7e8
+async def status_vectors(ctx: typer.Context) -> None:
+    """Show vector store health and collection statistics."""
+    client = CoreApiClient()
+    try:
+        result = await client.vectors.status()
+    except Exception as exc:
+        console.print(f"[bold red]Qdrant Connection Failed:[/bold red] {exc}")
+        raise typer.Exit(1) from exc
+    collections = result.get("collections", [])
+    if not collections:
+        console.print("[yellow]No Qdrant collections found.[/yellow]")
+        return
+    table = Table(title="Qdrant Collections")
+    table.add_column("Collection", style="cyan")
+    table.add_column("Status", justify="center")
+    for coll in collections:
+        table.add_row(coll["name"], coll.get("status", "active"))
+    console.print(table)

core_cli/resources/vectors/sync.py

@@ -0,0 +1,50 @@
+# src/core_cli/resources/vectors/sync.py
+
+"""Thin client over POST /v1/sync/vectors (ADR-058 D2)."""
+
+from __future__ import annotations
+
+import logging
+
+import typer
+from rich.console import Console
+
+from api.cli import CoreApiClient
+from cli.utils import core_command
+
+from .hub import app
+
+
+logger = logging.getLogger(__name__)
+console = Console()
+
+
+@app.command("sync")
+@core_command(requires_context=False, dangerous=True)
+# ID: 558c245a-7663-4a87-bf2d-4e3c612498bd
+async def sync_vectors(
+    ctx: typer.Context,
+    write: bool = typer.Option(False, "--write", help="Apply changes to Qdrant."),
+    target: str = typer.Option(
+        "all", "--target", "-t", help="Target: policies, patterns, or all"
+    ),
+) -> None:
+    """Synchronize constitutional documents to vector collections."""
+    _ = ctx
+    console.print(
+        f"[bold cyan]Vector Sync (Constitution): "
+        f"{'WRITE' if write else 'DRY-RUN'}[/bold cyan]"
+    )
+    client = CoreApiClient()
+    initial = await client.sync_vectors(write=write, target=target)
+    run_id = initial.get("run_id")
+    if not run_id:
+        console.print(f"[red]sync_vectors failed to dispatch: {initial}[/red]")
+        raise typer.Exit(1)
+    final = await client.poll_sync_run(run_id)
+    if final.get("status") != "completed":
+        console.print(
+            f"[red]Vector sync failed: {final.get('error') or final}[/red]"
+        )
+        raise typer.Exit(1)
+    console.print("[green]Vector sync completed[/green]")

core_cli/resources/vectors/sync_code.py

@@ -0,0 +1,58 @@
+# src/core_cli/resources/vectors/sync_code.py
+
+"""Thin client over POST /v1/sync/code-vectors (ADR-058 D2)."""
+
+from __future__ import annotations
+
+import logging
+
+import typer
+from rich.console import Console
+
+from api.cli import CoreApiClient
+from cli.utils import core_command
+
+from .hub import app
+
+
+logger = logging.getLogger(__name__)
+console = Console()
+
+
+@app.command("sync-code")
+@core_command(dangerous=True, requires_context=False)
+# ID: 6489b6df-f2d8-4480-b0e2-e3054c9c11dc
+async def sync_code_cmd(
+    ctx: typer.Context,
+    write: bool = typer.Option(False, "--write", help="Commit vectors to Qdrant."),
+    force: bool = typer.Option(
+        False, "--force", help="Force re-vectorization of all symbols."
+    ),
+) -> None:
+    """Synchronize codebase symbol embeddings with the vector database."""
+    _ = ctx
+    mode = "SYNCING" if write else "ANALYZING"
+    if force and write:
+        console.print("[bold yellow]--force: re-embedding all artifacts[/bold yellow]")
+    console.print(f"[bold cyan]{mode} codebase vectors...[/bold cyan]")
+    client = CoreApiClient()
+    initial = await client.sync_code_vectors(write=write, force=force)
+    run_id = initial.get("run_id")
+    if not run_id:
+        console.print(f"[red]sync_code_vectors failed to dispatch: {initial}[/red]")
+        raise typer.Exit(1)
+    final = await client.poll_sync_run(run_id)
+    if final.get("status") != "completed":
+        console.print(
+            f"[red]Code vector sync failed: {final.get('error') or final}[/red]"
+        )
+        raise typer.Exit(1)
+    action_data = (final.get("result") or {}).get("data") or {}
+    if action_data.get("status") == "partial":
+        remaining = action_data.get("pending_remaining", "?")
+        console.print(
+            f"[yellow]Embed cap reached — {remaining} artifact(s) still "
+            f"pending. Re-run sync-code or wait for RepoEmbedderWorker.[/yellow]"
+        )
+    else:
+        console.print("[green]Code vector sync completed[/green]")

core_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: core-cli
+Version: 1.0.0
+Summary: Consumer governance CLI for CORE — pure HTTP client for governing repositories against CORE constitutional rules.
+Project-URL: Homepage, https://github.com/DariuszNewecki/CORE
+Project-URL: Repository, https://github.com/DariuszNewecki/core-cli
+Project-URL: Bug Tracker, https://github.com/DariuszNewecki/core-cli/issues
+Author-email: Dariusz Newecki <d.newecki@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: cli,code-quality,constitutional-ai,developer-tools,governance
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.12
+Requires-Dist: core-runtime>=2.8.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# core-cli
+
+Consumer governance CLI for [CORE](https://github.com/DariuszNewecki/CORE) — pure HTTP client for governing repositories against CORE constitutional rules.
+
+## Install
+
+```bash
+pip install core-cli
+```
+
+## Usage
+
+```bash
+core lane list
+core proposals list
+core code audit_duplicates --help
+core symbols audit --help
+core vectors query --help
+core project onboard --help
+```
+
+Requires a running CORE instance. Configure via environment:
+
+```bash
+export CORE_API_URL=http://localhost:8000
+```
+
+## Commands
+
+| Namespace | Commands |
+|-----------|----------|
+| `lane` | `list`, `next`, `claim`, `propose` |
+| `proposals` | `list`, `create`, `show`, `approve`, `reject`, `execute` |
+| `secrets` | manage encrypted secrets |
+| `code` | `actions`, `audit_duplicates`, `bridges`, `check_imports`, `check_ui`, `docstrings`, `fix_atomic`, `format`, `integrity`, `lint`, `logging`, `test` |
+| `symbols` | `audit`, `fix_ids`, `resolve_duplicates`, `sync` |
+| `vectors` | `query`, `rebuild`, `status`, `sync`, `sync_code` |
+| `project` | `docs`, `onboard`, `scout` |
+
+## Architecture
+
+All commands communicate exclusively over the CORE HTTP API — no in-process access required.
+`core-cli` depends on `core-runtime` for shared HTTP client infrastructure (`api.cli.*`)
+and CLI utilities (`cli.utils.*`).
+
+See [ADR-146](https://github.com/DariuszNewecki/CORE/blob/main/.specs/decisions/ADR-146-cli-consumer-operator-split.md) for the consumer/operator split rationale.

core_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,52 @@
+core_cli/__init__.py,sha256=SEBPYaEKgMOUhXCt4F6PNzfdIsnKBVFSGEG1BSCWWpA,89
+core_cli/main.py,sha256=NHje48tDA64mtIhot-00xiauqYgmKM5RS1eqa5TIs6E,1047
+core_cli/resources/__init__.py,sha256=njVhPBMVW45xB1Y1MoWgssDS2dcndN5tmuh-A4Rpr5g,78
+core_cli/resources/code/__init__.py,sha256=0O01lLr4EKZ_qo9qCP4Y9RxEWf4sCPgyzmLJDFXXEgQ,364
+core_cli/resources/code/actions.py,sha256=wii4_m0ISeAf9a7zDaNV5mJMI9Pp2sGfEh3JeBVX-08,1663
+core_cli/resources/code/audit_duplicates.py,sha256=Vk14kJyswf9ba3ADzX-CxdjAZqmRhXJ95xYoWBj3nyI,1132
+core_cli/resources/code/bridges.py,sha256=qnn-6Vc8_IBM3nY1nBJfecx6pL5YAhCDZQKqK___j2Q,2798
+core_cli/resources/code/check_imports.py,sha256=m9YsPnhCCsvafnNxpr2G9P06XimJfCHbO4Ii-MPyd-s,2365
+core_cli/resources/code/check_ui.py,sha256=N-8wCBJ8esucVw8gULgMSmr4_lxeEnoKHVCvAiN-jpQ,2143
+core_cli/resources/code/docstrings.py,sha256=jf7q8f621p18gjiwJNbbwQ39T3EsnPe6JdSoUCxxm3I,1396
+core_cli/resources/code/fix_atomic.py,sha256=A0w7b_jqTdMn9i2HiC_MPfIjmdiwRehYjmOLZGzzSyk,1626
+core_cli/resources/code/format.py,sha256=DnEL_WushtVL_mlF85EZbIDcrt_E3LHQ3Nbgr5jEUeQ,1917
+core_cli/resources/code/hub.py,sha256=Ns5C-Zm9-9jZ32CHVRGu55EZ205mQmMWODTV1nyCDZg,251
+core_cli/resources/code/integrity.py,sha256=fHzKMIjSBwVOp3Cc4BC-eMKW9m7l4sXht_OxVt0WUvM,2255
+core_cli/resources/code/lint.py,sha256=snBSWTMqrQnVZKyD-sTx-4y4PuXkORptW7y9nSYl4BQ,1192
+core_cli/resources/code/logging.py,sha256=wHdVB8-dkGuelfyhfmtW9DWaGpDbx8bgpwYt7o6X91I,1679
+core_cli/resources/code/test.py,sha256=KJ-gIY_8h6epUd-W9f_89_b8NBjQE9HIYcNNYT7CoZA,1004
+core_cli/resources/lane/__init__.py,sha256=eLxHUMJ1jihcK8axXADWQnmKuR-DSvFLvXirqAKls0Q,651
+core_cli/resources/lane/claim.py,sha256=0thJ8QS6-nm4W7Jwcq_YWb5jZQQqGzNWYd8vBzFnq-0,1427
+core_cli/resources/lane/list.py,sha256=qlFtn0FK74RpgSPNjAQMhlgANMMCR4_Ainn4krx5uYc,1570
+core_cli/resources/lane/next.py,sha256=Tz7m_8sZfZkUrPrnXRL7hTQ3k3RJFCfeFtdo-DeKEqc,3101
+core_cli/resources/lane/propose.py,sha256=NXha6qoGvq0Ojvf6Z1OPeIDYI_NJcycyKABqifSTfXU,4742
+core_cli/resources/project/__init__.py,sha256=A51y6JVwor0i3LU4iHjcNswvIYB_8zElsauMs-zVeFE,331
+core_cli/resources/project/docs.py,sha256=HnP7cKEjS1x1b7LELWY8NM7zGAZoEOHO1vbFFr3Rbo8,1127
+core_cli/resources/project/onboard.py,sha256=yDPzu4cy2Yuk6OxEDEAekqfa9B1zn9y6W-6Kv2CBWnI,3765
+core_cli/resources/project/scout.py,sha256=oMB-YMaB4GZA4jTN8oT1Xlxh4KgFc3WwLPZrQQIsq68,10715
+core_cli/resources/proposals/__init__.py,sha256=ugOfVDfBhQ6wCWVT_1ObuayVVlbmbVcQ1IN9hBoWKy8,670
+core_cli/resources/proposals/create.py,sha256=78eqD9XNh4k3qIxQXZFKP9Ahc7QoRUNdGp3R2dj5isg,3332
+core_cli/resources/proposals/integrate.py,sha256=ubFuLTqaNv99xxj1bRyHNXQVSTb1S0PdRNZSeGQ6NSY,1807
+core_cli/resources/proposals/list.py,sha256=O7QhqEuj5koOpU65wXRNzOWA6pxfajo-OIf3eTMOFqw,3950
+core_cli/resources/proposals/manage.py,sha256=LgjVVoKlBrDnZLEGsoFkMsqZHBA46EnprD3fxTjpSF0,7157
+core_cli/resources/secrets/__init__.py,sha256=I0NzTf6JjVbS5OqRJHXICeZJ2WwezHiR_3kDHqDUGX8,181
+core_cli/resources/secrets/hub.py,sha256=i8Wn8So5KC0QKvRYy70_-On3p894j-MCQKNp3wEOijc,171
+core_cli/resources/secrets/manage.py,sha256=csRf9mOcJy3mV6A3LKhhaXl2xVPa1oDfGNt7emfFg_8,5567
+core_cli/resources/symbols/__init__.py,sha256=m_HWsjsWQHUZdpdYk0FV10pzak2a5vx2taer-5UEXaE,209
+core_cli/resources/symbols/audit.py,sha256=XrXmqcdUcc10mLZvIDnCGjoo9MOmk3OHkvLDaR_CSz4,2155
+core_cli/resources/symbols/fix_ids.py,sha256=N54KIBtBeLbIdKIukPm0354r0SBzl8ZZ0nHjfasZBRg,1248
+core_cli/resources/symbols/hub.py,sha256=GZ4Tiie5gmqg5renJscBiby39RzhZgYf59SuiDghbWI,244
+core_cli/resources/symbols/resolve_duplicates.py,sha256=1O8xtQZAqBfyiCsHKHg0lwMVLxRlTqdiN6aLB_AS3wM,1271
+core_cli/resources/symbols/sync.py,sha256=yzOCs-xu33z7LPBk0zyzYsxj2at4h8Aps6VtRknp3xk,1212
+core_cli/resources/vectors/__init__.py,sha256=qi2KaOr6VImuwoY4LN1snSupYSsFW1TGEAuSBOGeSuQ,209
+core_cli/resources/vectors/hub.py,sha256=SWiPZfjbfnlROKNp7TDQrzzQkGpJq5lus1qfrZcMmv4,163
+core_cli/resources/vectors/query.py,sha256=5-BcNhasowm6eG5qSkgQ-rWdJJ6bPTcwBBYlXEx0fGk,2185
+core_cli/resources/vectors/rebuild.py,sha256=SPFcadKSA1cs3b9OFIU4hUyap-Rf-xrf9P7y90-Jb18,2384
+core_cli/resources/vectors/status.py,sha256=5JGYmBFSj5b3KDV6DGimHLur9JIjLqrY6T1uzLAaEGk,1236
+core_cli/resources/vectors/sync.py,sha256=op-OF1aWbYWeIrCIOPia0hZrgy943yWVFpg65qhWqyY,1486
+core_cli/resources/vectors/sync_code.py,sha256=7aGXTmp6l2tHKL66lRWYbhEoA039og00DAMlqA72n7I,1999
+core_cli-1.0.0.dist-info/METADATA,sha256=Mh-ldfonjgeKkXPEUnlX1s-womQTw8YaLwG3PMYTG88,2603
+core_cli-1.0.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+core_cli-1.0.0.dist-info/entry_points.txt,sha256=5UYjgogTDOkUfPmfp63MXfl1kFWrhu16Lsu3J2Zoo44,43
+core_cli-1.0.0.dist-info/licenses/LICENSE,sha256=6z3Onp7hLf7mxotdvaL92qhdy5NenJNTnHtRJl6wCC4,1072
+core_cli-1.0.0.dist-info/RECORD,,

core_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

core_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+core = core_cli.main:app

core_cli-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Dariusz Newecki
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.