darwin-agentic-cloud 3.0.1__tar.gz → 3.0.2__tar.gz

{darwin_agentic_cloud-3.0.1 → darwin_agentic_cloud-3.0.2}/.gitignore

@@ -100,3 +100,10 @@ logs/
 # DAC-specific
 attestations/
 .dac-state/
+
+# macOS Finder duplicate artifacts
+* 2.md
+* 2.sh
+* 2.lock
+*\ 2/
+README.v2.0.0.md.bak

{darwin_agentic_cloud-3.0.1 → darwin_agentic_cloud-3.0.2}/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.0.2] — 2026-05-28
+
+### Added
+
+- First-run welcome banner. When a user runs any `darwin` command for the first
+  time after install, an ASCII brand banner prints with the tagline, motto, three
+  starter commands, and links to demo, repo, and docs. Shown once per install
+  via a marker file at `~/.darwin/welcomed`. Suppressed in non-interactive shells
+  (pipes, scripts, CI) and when `DARWIN_SUPPRESS_WELCOME=1` is set.
+- `darwin welcome` command to re-trigger the banner on demand.
+
+### Internal
+
+- New `render_welcome()` and `print_welcome()` functions in
+  `darwin/agenticcloud/ui.py`, reusing the existing `BANNER`, `BRAND_GREEN`,
+  `BRAND_AMBER`, and `BRAND_DIM` brand tokens for visual continuity with the
+  attestation cert panel.
+
 ## [3.0.1] — 2026-05-27
 
 ### Fixed

{darwin_agentic_cloud-3.0.1 → darwin_agentic_cloud-3.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: darwin-agentic-cloud
-Version: 3.0.1
+Version: 3.0.2
 Summary: Darwin — adaptive software systems. Includes darwin.agenticcloud, the verifiable agentic cloud. Open-source compute for AI agents with cryptographically signed attestations.
 Project-URL: Homepage, https://github.com/vje013/darwin-agentic-cloud
 Project-URL: Repository, https://github.com/vje013/darwin-agentic-cloud
@@ -275,7 +275,7 @@ Description-Content-Type: text/markdown
 [![Python: 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![Schema: v0.2](https://img.shields.io/badge/schema-v0.2-FFB86C.svg)](https://darwin-agentic-cloud.fly.dev/.well-known/schemas/attestation/v0.2)
 
-> **Verifiable compute for AI agents.** Every workload signed. Every cost capped. Every routing decision auditable. Open verification, paid signing.
+> **Verifiable compute for AI agents.** Every workload signed. Every cost capped. Every routing decision auditable. Open source, verified, free compute.
 
 **Install:** `pip install darwin-agentic-cloud`
 
@@ -285,6 +285,11 @@ Description-Content-Type: text/markdown
 
 **v0.2 Schema:** https://darwin-agentic-cloud.fly.dev/.well-known/schemas/attestation/v0.2
 
+---
+## Darwin's Mission
+
+Increase AI adoption by increasing AI safety.
+
 ---
 
 ## The question agents can't answer today

{darwin_agentic_cloud-3.0.1 → darwin_agentic_cloud-3.0.2}/README.md

@@ -6,7 +6,7 @@
 [![Python: 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![Schema: v0.2](https://img.shields.io/badge/schema-v0.2-FFB86C.svg)](https://darwin-agentic-cloud.fly.dev/.well-known/schemas/attestation/v0.2)
 
-> **Verifiable compute for AI agents.** Every workload signed. Every cost capped. Every routing decision auditable. Open verification, paid signing.
+> **Verifiable compute for AI agents.** Every workload signed. Every cost capped. Every routing decision auditable. Open source, verified, free compute.
 
 **Install:** `pip install darwin-agentic-cloud`
 
@@ -16,6 +16,11 @@
 
 **v0.2 Schema:** https://darwin-agentic-cloud.fly.dev/.well-known/schemas/attestation/v0.2
 
+---
+## Darwin's Mission
+
+Increase AI adoption by increasing AI safety.
+
 ---
 
 ## The question agents can't answer today

{darwin_agentic_cloud-3.0.1 → darwin_agentic_cloud-3.0.2}/darwin/__init__.py

@@ -5,7 +5,7 @@ A family of modules:
     (more to come)
 """
 
-__version__ = "3.0.1"
+__version__ = "3.0.2"
 __author__ = "Vladimir J Edouard"
 __license__ = "Apache-2.0"
 

{darwin_agentic_cloud-3.0.1 → darwin_agentic_cloud-3.0.2}/darwin/agenticcloud/cli.py

@@ -14,6 +14,8 @@ Examples:
 from __future__ import annotations
 
 import json
+import os
+import sys
 from datetime import UTC
 from pathlib import Path
 from typing import Annotated
@@ -35,6 +37,63 @@ app = typer.Typer(
     no_args_is_help=True,
     add_completion=False,
 )
+
+
+# -------------------------------------------------------------------
+# First-run welcome
+# -------------------------------------------------------------------
+
+_WELCOME_MARKER = Path.home() / ".darwin" / "welcomed"
+
+
+def _show_welcome_if_first_run() -> None:
+    """Print the welcome banner exactly once per user install.
+
+    Suppressed in non-interactive shells, when piped, or when the user
+    sets DARWIN_SUPPRESS_WELCOME=1. The marker file at
+    ~/.darwin/welcomed records that the user has been welcomed.
+    """
+    try:
+        if not sys.stdout.isatty():
+            return
+        if os.environ.get("DARWIN_SUPPRESS_WELCOME"):
+            return
+        if _WELCOME_MARKER.exists():
+            return
+
+        from darwin import __version__ as _v
+        from darwin.agenticcloud.ui import print_welcome
+
+        print_welcome(Console(), version=_v)
+
+        _WELCOME_MARKER.parent.mkdir(parents=True, exist_ok=True)
+        _WELCOME_MARKER.touch()
+    except Exception:
+        # Welcome banner must never block real commands. If anything
+        # goes wrong here (terminal weirdness, IO error, etc.), swallow
+        # silently and proceed with the user's command.
+        pass
+
+
+@app.callback()
+def _root(ctx: typer.Context) -> None:
+    """Darwin Agentic Cloud — verifiable compute for AI agents."""
+    # The `welcome` command renders the banner itself; skip the
+    # auto-trigger here to avoid double-rendering.
+    if ctx.invoked_subcommand == "welcome":
+        return
+    _show_welcome_if_first_run()
+
+
+@app.command()
+def welcome() -> None:
+    """Show the Darwin welcome banner."""
+    from darwin import __version__ as _v
+    from darwin.agenticcloud.ui import print_welcome
+
+    print_welcome(Console(), version=_v)
+
+
 keys_app = typer.Typer(help="Manage signing keys.", no_args_is_help=True)
 attest_app = typer.Typer(help="Work with attestations.", no_args_is_help=True)
 history_app = typer.Typer(help="Query attestation history.", no_args_is_help=True)

{darwin_agentic_cloud-3.0.1 → darwin_agentic_cloud-3.0.2}/darwin/agenticcloud/ui.py

@@ -91,6 +91,103 @@ def print_banner(
     console.print()
 
 
+# -------------------------------------------------------------------
+# First-run welcome
+# -------------------------------------------------------------------
+
+
+def render_welcome(
+    version: str,
+    demo_url: str = "https://darwin-agentic-cloud.fly.dev/demo",
+    repo_url: str = "https://github.com/vje013/darwin-agentic-cloud",
+    docs_url: str = "https://darwin-agentic-cloud.fly.dev/docs",
+) -> Group:
+    """First-run welcome: ASCII banner + tagline + 3 commands + links.
+
+    Visually distinct from `render_banner()` (which prints version/signer
+    metadata for repeat users). Designed to orient a new user in their
+    first 30 seconds with the tool.
+    """
+    parts: list = []
+
+    parts.append(Text(BANNER, style=f"bold {BRAND_GREEN}"))
+    parts.append(Text(""))
+
+    motto = Text()
+    motto.append("  ")
+    motto.append("✦", style=f"bold {BRAND_AMBER}")
+    motto.append("  SECURITAS · STABILITAS · SIGNUM  ", style=BRAND_GREEN)
+    motto.append("✦", style=f"bold {BRAND_AMBER}")
+    parts.append(motto)
+    parts.append(Text(""))
+
+    parts.append(Text("  Verifiable and free compute for AI agents.", style=f"bold {BRAND_GREEN}"))
+    parts.append(
+        Text("  Cryptographically signed execution attestations.", style=f"bold {BRAND_GREEN}")
+    )
+    parts.append(Text("  MCP-native.", style=f"bold {BRAND_GREEN}"))
+    parts.append(Text(""))
+
+    parts.append(Text("  " + "─" * 59, style=BRAND_DIM))
+    parts.append(Text(""))
+
+    parts.append(Text("  Try it in 3 commands:", style=f"bold {BRAND_GREEN}"))
+    parts.append(Text(""))
+
+    cmd1 = Text("    1.  ", style=f"bold {BRAND_GREEN}")
+    cmd1.append("darwin list", style=f"bold {BRAND_GREEN}")
+    parts.append(cmd1)
+    parts.append(
+        Text("        See which compute substrates are available right now.", style=BRAND_GREEN)
+    )
+    parts.append(Text(""))
+
+    cmd2 = Text("    2.  ", style=f"bold {BRAND_GREEN}")
+    cmd2.append("echo 'print(\"hello\")' > hello.py", style=BRAND_GREEN)
+    parts.append(cmd2)
+    parts.append(Text("        darwin run hello.py --save att.json", style=f"bold {BRAND_GREEN}"))
+    parts.append(Text("        Execute a workload, get a signed attestation.", style=BRAND_GREEN))
+    parts.append(Text(""))
+
+    cmd3 = Text("    3.  ", style=f"bold {BRAND_GREEN}")
+    cmd3.append("darwin verify att.json", style=f"bold {BRAND_GREEN}")
+    parts.append(cmd3)
+    parts.append(
+        Text("        Cryptographically verify the attestation against", style=BRAND_GREEN)
+    )
+    parts.append(Text("        the public keylist.", style=BRAND_GREEN))
+    parts.append(Text(""))
+
+    parts.append(Text("  " + "─" * 59, style=BRAND_DIM))
+    parts.append(Text(""))
+
+    link_demo = Text("  Live demo:  ", style=BRAND_GREEN)
+    link_demo.append(demo_url, style=f"underline {BRAND_GREEN}")
+    parts.append(link_demo)
+
+    link_repo = Text("  GitHub:     ", style=BRAND_GREEN)
+    link_repo.append(repo_url, style=f"underline {BRAND_GREEN}")
+    parts.append(link_repo)
+
+    link_docs = Text("  Docs:       ", style=BRAND_GREEN)
+    link_docs.append(docs_url, style=f"underline {BRAND_GREEN}")
+    parts.append(link_docs)
+
+    parts.append(Text(""))
+
+    parts.append(Text("  This message shown once per install.", style=BRAND_DIM))
+    parts.append(Text("  Run `darwin welcome` to see it again.", style=BRAND_DIM))
+
+    return Group(*parts)
+
+
+def print_welcome(console: Console, version: str) -> None:
+    """Convenience: print the welcome with appropriate vertical spacing."""
+    console.print()
+    console.print(render_welcome(version=version))
+    console.print()
+
+
 # -------------------------------------------------------------------
 # Matrix boot sequence
 # -------------------------------------------------------------------

{darwin_agentic_cloud-3.0.1 → darwin_agentic_cloud-3.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "darwin-agentic-cloud"
-version = "3.0.1"
+version = "3.0.2"
 description = "Darwin — adaptive software systems. Includes darwin.agenticcloud, the verifiable agentic cloud. Open-source compute for AI agents with cryptographically signed attestations."
 readme = "README.md"
 requires-python = ">=3.11"