dirigent-cli 0.20.0__tar.gz → 0.21.0__tar.gz

{dirigent_cli-0.20.0 → dirigent_cli-0.21.0}/PKG-INFO

@@ -1,19 +1,19 @@
 Metadata-Version: 2.4
 Name: dirigent-cli
-Version: 0.20.0
+Version: 0.21.0
 Summary: The dirigent command line interface (dirigent / dg).
 License-Expression: LicenseRef-Proprietary
 License-File: LICENSE
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: dirigent-block-execute==0.20.0
-Requires-Dist: dirigent-blocks==0.20.0
-Requires-Dist: dirigent-client==0.20.0
-Requires-Dist: dirigent-common==0.20.0
-Requires-Dist: dirigent-core==0.20.0
-Requires-Dist: dirigent-examples==0.20.0
-Requires-Dist: dirigent-plugin==0.20.0
-Requires-Dist: dirigent-server==0.20.0
+Requires-Dist: dirigent-block-execute==0.21.0
+Requires-Dist: dirigent-blocks==0.21.0
+Requires-Dist: dirigent-client==0.21.0
+Requires-Dist: dirigent-common==0.21.0
+Requires-Dist: dirigent-core==0.21.0
+Requires-Dist: dirigent-examples==0.21.0
+Requires-Dist: dirigent-plugin==0.21.0
+Requires-Dist: dirigent-server==0.21.0
 Requires-Dist: httpx2>=2.12.0
 Requires-Dist: python-dotenv>=1.1.0
 Requires-Dist: pyyaml>=6.0.3

{dirigent_cli-0.20.0 → dirigent_cli-0.21.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dirigent-cli"
-version = "0.20.0"
+version = "0.21.0"
 description = "The dirigent command line interface (dirigent / dg)."
 readme = "README.md"
 requires-python = ">=3.13"
@@ -11,14 +11,14 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "dirigent-block-execute==0.20.0",
-    "dirigent-blocks==0.20.0",
-    "dirigent-client==0.20.0",
-    "dirigent-common==0.20.0",
-    "dirigent-core==0.20.0",
-    "dirigent-examples==0.20.0",
-    "dirigent-plugin==0.20.0",
-    "dirigent-server==0.20.0",
+    "dirigent-block-execute==0.21.0",
+    "dirigent-blocks==0.21.0",
+    "dirigent-client==0.21.0",
+    "dirigent-common==0.21.0",
+    "dirigent-core==0.21.0",
+    "dirigent-examples==0.21.0",
+    "dirigent-plugin==0.21.0",
+    "dirigent-server==0.21.0",
     "httpx2>=2.12.0",
     "python-dotenv>=1.1.0",
     "pyyaml>=6.0.3",

{dirigent_cli-0.20.0 → dirigent_cli-0.21.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "dirigent-cli"
-version = "0.20.0"
+version = "0.21.0"
 description = "The dirigent command line interface (dirigent / dg)."
 readme = "README.md"
 requires-python = ">=3.13"
@@ -11,14 +11,14 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "dirigent-block-execute==0.20.0",
-    "dirigent-blocks==0.20.0",
-    "dirigent-client==0.20.0",
-    "dirigent-common==0.20.0",
-    "dirigent-core==0.20.0",
-    "dirigent-examples==0.20.0",
-    "dirigent-plugin==0.20.0",
-    "dirigent-server==0.20.0",
+    "dirigent-block-execute==0.21.0",
+    "dirigent-blocks==0.21.0",
+    "dirigent-client==0.21.0",
+    "dirigent-common==0.21.0",
+    "dirigent-core==0.21.0",
+    "dirigent-examples==0.21.0",
+    "dirigent-plugin==0.21.0",
+    "dirigent-server==0.21.0",
     "httpx2>=2.12.0",
     "python-dotenv>=1.1.0",
     "pyyaml>=6.0.3",

{dirigent_cli-0.20.0 → dirigent_cli-0.21.0}/src/dirigent_cli/commands.py

@@ -350,7 +350,9 @@ def apply_command(
     as_code: Annotated[str | None, typer.Option("--as", help="Register under a different code.")] = None,
     paused: Annotated[
         bool,
-        typer.Option("--paused", help="Create the schedules this apply mints paused; existing ones are untouched."),
+        typer.Option(
+            "--paused", help="Create the schedules and watches this apply mints paused; existing ones are untouched."
+        ),
     ] = False,
     prune: Annotated[
         bool,

{dirigent_cli-0.20.0 → dirigent_cli-0.21.0}/src/dirigent_cli/local.py

@@ -645,7 +645,8 @@ async def run_document(
                 async with session_scope(sessions) as session:
                     await _apply_supporting(session, services, extra_definition)
             async with session_scope(sessions) as session:
-                applied = await apply_document(session, services, definition)
+                # Triggers land paused: the instance runs only the run it was asked for.
+                applied = await apply_document(session, services, definition, pause_schedules=True)
                 if not applied.plan.ok:
                     raise LocalError(
                         "the document does not validate against the installed catalog:\n"
@@ -697,8 +698,8 @@ def _parse_supporting(text: str) -> PipelineDefinition:
 
 
 async def _apply_supporting(session: AsyncSession, services: EngineServices, supporting: PipelineDefinition) -> None:
-    """Apply one document a run depends on, without running it."""
-    applied = await apply_document(session, services, supporting)
+    """Apply one document a run depends on, without running it or arming its triggers."""
+    applied = await apply_document(session, services, supporting, pause_schedules=True)
     if not applied.plan.ok:
         raise LocalError(
             f"the supporting document {supporting.code!r} does not validate:\n"

{dirigent_cli-0.20.0 → dirigent_cli-0.21.0}/src/dirigent_cli/main.py

@@ -127,6 +127,7 @@ app.add_typer(commands.schema_app, rich_help_panel=DEFINE_PANEL)
 app.add_typer(commands.connection_app, rich_help_panel=CONNECT_PANEL)
 app.add_typer(triggers.schedule_app, rich_help_panel=TRIGGER_PANEL)
 app.add_typer(triggers.webhook_app, rich_help_panel=TRIGGER_PANEL)
+app.add_typer(triggers.watch_app, rich_help_panel=TRIGGER_PANEL)
 app.add_typer(triggers.trigger_document_app, rich_help_panel=TRIGGER_PANEL)
 app.add_typer(triggers.alerts_app, rich_help_panel=TRIGGER_PANEL)
 app.add_typer(docker_app, rich_help_panel=PROCESS_PANEL)
@@ -911,7 +912,7 @@ def dev(
         typer.Option(
             "--seed",
             help="Apply every dirigent/v1 document under this directory once the API answers, "
-            "with its schedules paused; name it more than once to seed one directory after another.",
+            "with its schedules and watches paused; name it more than once to seed one directory after another.",
         ),
     ] = None,
     seed_installed: Annotated[
@@ -934,7 +935,7 @@ def dev(
 
     --seed fills the instance from a directory of documents the moment it answers: the
     connections a file or a document declares are created first, then every document is
-    applied with its schedules paused. A document an instance will not store is reported
+    applied with its schedules and watches paused. A document an instance will not store is reported
     and passed over, because a corpus holds those on purpose.
     """
     import asyncio

{dirigent_cli-0.20.0 → dirigent_cli-0.21.0}/src/dirigent_cli/seeding.py

@@ -136,7 +136,7 @@ async def _connection(client: Dirigent, spec: ConnectionSpec) -> str:
 
 
 async def _apply(client: Dirigent, raw: JsonMap, origin: str) -> Record:
-    """Apply one document with its schedules paused, without the sections it carries."""
+    """Apply one document with its schedules and watches paused, without the sections it carries."""
     document = {name: value for name, value in raw.items() if name not in CARRIED}
     try:
         result = await client.pipelines.apply(
@@ -157,6 +157,7 @@ async def _apply(client: Dirigent, raw: JsonMap, origin: str) -> Record:
         pipeline=result.plan.code,
         action=result.plan.action.value,
         schedules_paused=result.triggers.schedules_created,
+        watches_paused=result.triggers.watches_created,
     )
 
 

{dirigent_cli-0.20.0 → dirigent_cli-0.21.0}/src/dirigent_cli/triggers.py

@@ -1,4 +1,4 @@
-"""The trigger and alerting command groups: schedules, webhooks, and alert rules."""
+"""The trigger and alerting command groups: schedules, webhooks, watches, and alert rules."""
 
 from pathlib import Path
 from typing import Annotated, Any, cast
@@ -35,6 +35,11 @@ schedule_app = typer.Typer(
     name="schedule", help="A pipeline's clocks: cron, interval, or one-time.", no_args_is_help=True
 )
 webhook_app = typer.Typer(name="webhook", help="Inbound webhooks and their delivery history.", no_args_is_help=True)
+watch_app = typer.Typer(
+    name="watch",
+    help="Sensors kept waiting: one run always waiting on each, the next armed on success.",
+    no_args_is_help=True,
+)
 trigger_document_app = typer.Typer(
     name="trigger-document",
     help="Documents that declare clocks for a pipeline defined elsewhere.",
@@ -246,6 +251,60 @@ def schedule_delete(
     emit_fact("schedule.deleted", message="deleted", code=code, pipeline=pipeline)
 
 
+@watch_app.command("list")
+def watch_list(
+    ctx: typer.Context,
+    pipeline: Annotated[str, typer.Argument(help="The pipeline whose watches to list.")],
+) -> None:
+    """List a pipeline's watches, each with the run it has waiting and how its waits are going."""
+    with client_for(state_of(ctx)) as dg:
+        rows = list(paged(lambda after, size: dg.call(dg.watches.list(pipeline, after=after, limit=size)), None))
+    emit_records("watch", rows)
+
+
+@watch_app.command("show")
+def watch_show(
+    ctx: typer.Context,
+    pipeline: Annotated[str, typer.Argument(help="The pipeline the watch belongs to.")],
+    code: Annotated[str, typer.Argument(help="The watch to show.")],
+) -> None:
+    """Show one watch: the step it waits on, where it left off, and its last error."""
+    with client_for(state_of(ctx)) as dg:
+        row = dg.call(dg.watches.get(pipeline, code))
+    emit_one("watch", row)
+
+
+@watch_app.command("pause")
+def watch_pause(
+    ctx: typer.Context,
+    pipeline: Annotated[str, typer.Argument()],
+    code: Annotated[str, typer.Argument()],
+) -> None:
+    """Stop a watch, cancelling the run it has waiting, and keep where it left off."""
+    with client_for(state_of(ctx)) as dg:
+        row = dg.call(dg.watches.pause(pipeline, code))
+    emit_fact("watch.paused", message="paused", code=code, pipeline=pipeline, cursor=row.cursor)
+
+
+@watch_app.command("resume")
+def watch_resume(
+    ctx: typer.Context,
+    pipeline: Annotated[str, typer.Argument()],
+    code: Annotated[str, typer.Argument()],
+) -> None:
+    """Start a watch again, arming a run from where its last success left off."""
+    with client_for(state_of(ctx)) as dg:
+        row = dg.call(dg.watches.resume(pipeline, code))
+    emit_fact(
+        "watch.resumed",
+        message="resumed",
+        code=code,
+        pipeline=pipeline,
+        waiting_run_id=row.waiting_run_id,
+        cursor=row.cursor,
+    )
+
+
 def _print_token(minted: WebhookTokenOut, *, base_url: str) -> None:
     """Print a minted token once, with the URL already assembled.
 
@@ -621,7 +680,7 @@ def trigger_document_show(
     ctx: typer.Context,
     code: Annotated[str, typer.Argument(help="The triggers document to read.")],
 ) -> None:
-    """Show one triggers document and the schedules and webhooks it owns."""
+    """Show one triggers document and the schedules, webhooks and watches it owns."""
     with client_for(state_of(ctx)) as dg:
         detail = dg.call(dg.trigger_documents.get(code))
     if state_of(ctx).json_output:
@@ -631,6 +690,7 @@ def trigger_document_show(
     console.print(f"  digest    [dim]{detail.digest}[/]")
     console.print(f"  schedules {', '.join(detail.schedules) or '-'}")
     console.print(f"  webhooks  {', '.join(detail.webhooks) or '-'}")
+    console.print(f"  watches   {', '.join(detail.watches) or '-'}")
     if detail.description:
         console.print(f"\n{detail.description}")
 
@@ -643,7 +703,14 @@ def trigger_document_delete(
     """Remove a triggers document and every schedule and webhook it declared."""
     with client_for(state_of(ctx)) as dg:
         dg.call(dg.trigger_documents.delete(code))
-    emit_fact("trigger_document.deleted", message="deleted", code=code, schedules="deleted", webhooks="deleted")
+    emit_fact(
+        "trigger_document.deleted",
+        message="deleted",
+        code=code,
+        schedules="deleted",
+        webhooks="deleted",
+        watches="deleted",
+    )
 
 
 @alerts_app.command("retry")