adopt-cli 0.4.0__tar.gz → 0.4.1__tar.gz

{adopt_cli-0.4.0 → adopt_cli-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: adopt-cli
-Version: 0.4.0
+Version: 0.4.1
 Summary: The adopt command surface: config resolution, JSON mode, exit codes.
 Project-URL: Homepage, https://github.com/onboardux/onboard-core
 Project-URL: Source, https://github.com/onboardux/onboard-core

{adopt_cli-0.4.0 → adopt_cli-0.4.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "adopt-cli"
-version = "0.4.0"
+version = "0.4.1"
 description = "The adopt command surface: config resolution, JSON mode, exit codes."
 requires-python = ">=3.12"
 license = "Apache-2.0"

adopt_cli-0.4.1/src/adopt_cli/_build_info.py

@@ -0,0 +1,6 @@
+"""Generated by scripts/embed_build_info.py; do not edit in a release build."""
+
+from typing import Final
+
+SBOM_SHA256: Final[str | None] = '6742b345c4d8f4d20905a7e8ca33afd66dd98e023cb9d13fb8982d3f2a3cd493'
+BUILD_ID: Final[str | None] = 'github:onboardux/onboard-core:34466475060:1:d639bc04586bda49c77f2b8c71865ceba74f2a0b'

{adopt_cli-0.4.0 → adopt_cli-0.4.1}/src/adopt_cli/commands/answer.py

@@ -63,6 +63,8 @@ class _Items(Protocol):
         self, *, revision_id: str, source_type: SourceType, source_ref: str
     ) -> str: ...
 
+    def tag_audience(self, *, item_id: str, audience: str) -> bool: ...
+
 
 class _Bindings(Protocol):
     def create(
@@ -113,6 +115,14 @@ ScopeOption = Annotated[
     str | None,
     typer.Option("--scope", help="firm/engagement/system/environment. Defaults to the store's."),
 ]
+AudienceOption = Annotated[
+    list[str] | None,
+    typer.Option(
+        "--audience",
+        help="Who the answer is for. Repeatable. Defaults to the same audience "
+        "`adopt ingest` gives an untagged document.",
+    ),
+]
 ActorOption = Annotated[str | None, typer.Option("--actor", help="Who answered.")]
 JsonOption = Annotated[bool, typer.Option("--json", help="Emit the strict JSON envelope only.")]
 
@@ -124,11 +134,12 @@ def answer(
     title: TitleOption = None,
     scope: ScopeOption = None,
     store: StoreOption = None,
+    audience: AudienceOption = None,
     actor: ActorOption = None,
     json_output: JsonOption = False,
 ) -> None:
     """Bank a human's answer as confirmed knowledge and resolve the question."""
-    from adopt_ask.capture import capture_answer, identities_to_bind
+    from adopt_ask.capture import DEFAULT_AUDIENCES, capture_answer, identities_to_bind
 
     from adopt_cli.commands._remote_support import configured_remote
 
@@ -169,6 +180,10 @@ def answer(
             title=title or existing.question or f"Answer to {escalation_id}",
             body_md=text,
             identity_ids=identity_ids,
+            # `DEFAULT_AUDIENCES` rather than a literal here: the default lives
+            # in `adopt_ask.capture` beside the rule it protects, so the CLI and
+            # the plane cannot drift into tagging captured answers differently.
+            audiences=tuple(audience) if audience else DEFAULT_AUDIENCES,
             actor_id=actor,
             unmatched_uris=unmatched,
         )
@@ -248,6 +263,9 @@ class _StoreAdapter:
             source_ref=source_ref,
         )
 
+    def tag_audience(self, *, item_id: str, audience: str) -> object:
+        return self._handle.items().tag_audience(item_id=item_id, audience=audience)
+
     def bind(self, *, item_id: str, identity_id: str, is_load_bearing: bool) -> str:
         binding_id, _revision_id = self._handle.bindings().create(
             item_id=item_id, identity_id=identity_id, is_load_bearing=is_load_bearing

{adopt_cli-0.4.0 → adopt_cli-0.4.1}/src/adopt_cli/commands/boundary.py

@@ -57,8 +57,8 @@ ScopeOption = Annotated[
     str | None,
     typer.Option(
         "--scope",
-        help="firm/engagement/system[/environment]. Given, the boundary is written to "
-        "the store; omitted, it is computed and reported without writing.",
+        help="firm/engagement/system, optionally with /environment. Given, the boundary is "
+        "written to the store; omitted, it is computed and reported without writing.",
     ),
 ]
 ArchetypeOption = Annotated[

{adopt_cli-0.4.0 → adopt_cli-0.4.1}/src/adopt_cli/commands/coverage.py

@@ -30,12 +30,23 @@ app = typer.Typer(
 )
 
 SystemOption = Annotated[
-    str,
-    typer.Option("--system", help="The system id to evaluate.", show_default=False),
+    str | None,
+    typer.Option("--system", help="System id or slug to evaluate.", show_default=False),
+]
+ScopeOption = Annotated[
+    str | None,
+    typer.Option(
+        "--scope",
+        help="firm/engagement/system, optionally with /environment. The alternative to "
+        "--system, and the string `adopt init` already took.",
+    ),
 ]
 EnvironmentOption = Annotated[
     str | None,
-    typer.Option("--environment", help="One environment id. Omit for every environment."),
+    typer.Option(
+        "--environment",
+        help="One environment id. Omit for every environment, or name one in --scope.",
+    ),
 ]
 StoreOption = Annotated[
     Path | None,
@@ -53,13 +64,27 @@ JsonOption = Annotated[bool, typer.Option("--json", help="Emit the strict JSON e
 
 @app.command()
 def recompute(
-    system: SystemOption,
+    system: SystemOption = None,
+    scope: ScopeOption = None,
     environment: EnvironmentOption = None,
     store: StoreOption = None,
     rebuild: RebuildOption = False,
     json_output: JsonOption = False,
 ) -> None:
-    """Evaluate the six inputs of contracts §6 for every identity in scope."""
+    """Evaluate the six inputs of contracts §6 for every identity in scope.
+
+    **`--scope` exists because this command is the remedy for an alarm, and the
+    remedy has to be reachable.** `COVERAGE_CACHE_DISAGREEMENT` fires on every
+    `adopt gaps` and `adopt pack` once a binding is confirmed, and clearing it
+    needs this verb -- which took a system **id** that no verb printed. `store
+    info` reports counts, `store doctor` reports findings, and the only command
+    that ever surfaced a system id was `adopt handover start`, which opens a
+    handover event as a side effect. An operator was left reading the SQLite
+    file by hand to silence an alarm the product raised at them, so the scope
+    string they typed into `adopt init` is now accepted here too.
+    """
+    from adopt_cli.commands._handover_support import resolve_system
+
     with open_configured_store(
         store,
         read_only=not rebuild,
@@ -69,7 +94,21 @@ def recompute(
         # nothing a later `adopt pull` overwrites was canon.
         non_canon_reason="--rebuild writes only the coverage cache, never canon",
     ) as handle:
-        result = recompute_coverage(handle.coverage_records(), system, environment)
+        # `resolve_system` rather than a second resolver: it already accepts an
+        # id, a slug or a scope path, refuses both at once, and with neither
+        # falls through to `resolve_scope`, which returns the store's only
+        # environment and **refuses rather than guessing** when there are
+        # several. A second implementation would be a second answer to "which
+        # system is this", which is how two verbs come to disagree about a store.
+        target = resolve_system(handle, system=system, scope=scope)
+        result = recompute_coverage(
+            handle.coverage_records(),
+            target.system_id,
+            # An explicit `--environment` wins over one named in `--scope`: it is
+            # the narrower statement of the two, and it names an id rather than a
+            # slug, so it cannot be the vaguer thing the operator meant.
+            environment or target.environment_id,
+        )
         rebuilt = rebuild_cache(handle.backend, result) if rebuild else 0
 
     payload = {

{adopt_cli-0.4.0 → adopt_cli-0.4.1}/src/adopt_cli/commands/handover.py

@@ -47,7 +47,8 @@ SystemOption = Annotated[
 ScopeOption = Annotated[
     str | None,
     typer.Option(
-        "--scope", help="firm/engagement/system[/environment]. Narrows to one environment."
+        "--scope",
+        help="firm/engagement/system, optionally with /environment. Narrows to one environment.",
     ),
 ]
 OwnerOption = Annotated[
@@ -396,7 +397,11 @@ def verify(
         raise AdoptError(
             ErrorCode.HANDOVER_CHECKLIST_INVALID,
             message=f"{checklist} is not valid YAML: {error}",
-            hint="See `docs/handover-checklist.example.yaml` for the shape.",
+            hint="A checklist is a mapping with a `tasks:` list, each task carrying `id`, "
+            "`task` and `outcome` (pass | fail | skipped). The annotated example is "
+            "docs/handover-checklist.example.yaml in the source tree, or "
+            "https://github.com/onboardux/onboard-core/blob/main/"
+            "docs/handover-checklist.example.yaml.",
         ) from error
     if not isinstance(raw, dict):
         raise AdoptError(

{adopt_cli-0.4.0 → adopt_cli-0.4.1}/src/adopt_cli/commands/policy.py

@@ -39,8 +39,8 @@ ScopeOption = Annotated[
     str | None,
     typer.Option(
         "--scope",
-        help="firm/engagement/system[/environment], to validate against the boundary "
-        "declared for that scope. Omitted, the strictest default boundary is used.",
+        help="firm/engagement/system, optionally with /environment, to validate against the "
+        "boundary declared for that scope. Omitted, the strictest default boundary is used.",
     ),
 ]
 StoreOption = Annotated[Path | None, typer.Option("--store", help="Store path override.")]

adopt_cli-0.4.0/src/adopt_cli/_build_info.py

@@ -1,6 +0,0 @@
-"""Generated by scripts/embed_build_info.py; do not edit in a release build."""
-
-from typing import Final
-
-SBOM_SHA256: Final[str | None] = '86636f02cad8578ffdc6c4b39fe311c0a8191cafd5fcb323ddb732447dc6b0c8'
-BUILD_ID: Final[str | None] = 'github:onboardux/onboard-core:34144382673:1:a1b32208f0a296bc708e283d860023ce7fdf4609'