omniship 0.1.0__tar.gz

omniship-0.1.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.3
+Name: omniship
+Version: 0.1.0
+Summary: Universal release orchestration
+Author: Ata Sesli
+Requires-Dist: click>=8.5.0
+Requires-Dist: pydantic>=2.13.5
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: rich>=15.0.0
+Requires-Python: >=3.14
+Project-URL: Homepage, https://github.com/0ctacity/omniship
+Project-URL: Repository, https://github.com/0ctacity/omniship
+Project-URL: Issues, https://github.com/0ctacity/omniship/issues
+Description-Content-Type: text/markdown
+
+# OmniShip (v0.1)
+
+OmniShip is a plugin-driven DAG executor designed around three strict stage boundaries:
+`Check` → `Build` → `Ship`.
+
+---
+
+## Architecture
+
+1. **Strict Stage Boundaries**:
+   - `CHECK`: Unit tests, integration tests, linting, code preparation.
+   - `BUILD`: Compiles binaries, bundles assets, produces named `Artifact`s.
+   - `SHIP`: Consumes produced artifacts, publishes releases, notifies destinations.
+   - All nodes in a stage must succeed before the next stage starts.
+
+2. **Async DAG Execution**:
+   - Sequential dependencies (`needs: [...]`)
+   - Concurrent parallel fan-out
+   - Fan-in barriers
+   - Automatic cycle detection
+   - Failure propagation & downstream skipping
+
+3. **First-Class Artifacts**:
+   - Build operations produce declared artifacts.
+   - Validated on disk, indexed in `ArtifactSet`, and made available to the `Ship` stage.
+
+4. **Plugin Architecture**:
+   - Standard Python package entry-point discovery: `omniship.plugins`.
+   - First-party operations use the exact same registration protocol as third-party plugins.
+   - Built-ins: `core/command`, `core/noop`, `github/release`.
+
+---
+
+## Configuration (`omniship.yaml`)
+
+```yaml
+version: 1
+
+check:
+  prepare:
+    uses: core/command
+    with:
+      run: ./scripts/prepare.sh
+
+  test-a:
+    uses: core/command
+    needs: [prepare]
+    with:
+      run: pytest tests/test_a.py
+
+  test-b:
+    uses: core/command
+    needs: [prepare]
+    with:
+      run: pytest tests/test_b.py
+
+build:
+  linux:
+    uses: core/command
+    with:
+      run: ./scripts/build-linux.sh
+      artifacts:
+        - dist/linux/app
+
+  macos:
+    uses: core/command
+    with:
+      run: ./scripts/build-macos.sh
+      artifacts:
+        - dist/macos/app
+
+ship:
+  github:
+    uses: github/release
+    with:
+      repository: octacity/example
+      tag: v0.1.0
+      dry_run: true
+```
+
+---
+
+## CLI Usage
+
+```bash
+# Run Check only
+omniship check
+
+# Run Check → Build
+omniship build
+
+# Run Build only (skip Check)
+omniship build --skip-check
+
+# Run full flow: Check → Build → Ship
+omniship ship
+
+# Inspect the execution DAG
+omniship plan
+
+# List registered plugins & operations
+omniship plugins
+
+# View operation details or generate YAML config template
+omniship plugin show core/command
+omniship plugin template core/command
+```

omniship-0.1.0/README.md

@@ -0,0 +1,107 @@
+# OmniShip (v0.1)
+
+OmniShip is a plugin-driven DAG executor designed around three strict stage boundaries:
+`Check` → `Build` → `Ship`.
+
+---
+
+## Architecture
+
+1. **Strict Stage Boundaries**:
+   - `CHECK`: Unit tests, integration tests, linting, code preparation.
+   - `BUILD`: Compiles binaries, bundles assets, produces named `Artifact`s.
+   - `SHIP`: Consumes produced artifacts, publishes releases, notifies destinations.
+   - All nodes in a stage must succeed before the next stage starts.
+
+2. **Async DAG Execution**:
+   - Sequential dependencies (`needs: [...]`)
+   - Concurrent parallel fan-out
+   - Fan-in barriers
+   - Automatic cycle detection
+   - Failure propagation & downstream skipping
+
+3. **First-Class Artifacts**:
+   - Build operations produce declared artifacts.
+   - Validated on disk, indexed in `ArtifactSet`, and made available to the `Ship` stage.
+
+4. **Plugin Architecture**:
+   - Standard Python package entry-point discovery: `omniship.plugins`.
+   - First-party operations use the exact same registration protocol as third-party plugins.
+   - Built-ins: `core/command`, `core/noop`, `github/release`.
+
+---
+
+## Configuration (`omniship.yaml`)
+
+```yaml
+version: 1
+
+check:
+  prepare:
+    uses: core/command
+    with:
+      run: ./scripts/prepare.sh
+
+  test-a:
+    uses: core/command
+    needs: [prepare]
+    with:
+      run: pytest tests/test_a.py
+
+  test-b:
+    uses: core/command
+    needs: [prepare]
+    with:
+      run: pytest tests/test_b.py
+
+build:
+  linux:
+    uses: core/command
+    with:
+      run: ./scripts/build-linux.sh
+      artifacts:
+        - dist/linux/app
+
+  macos:
+    uses: core/command
+    with:
+      run: ./scripts/build-macos.sh
+      artifacts:
+        - dist/macos/app
+
+ship:
+  github:
+    uses: github/release
+    with:
+      repository: octacity/example
+      tag: v0.1.0
+      dry_run: true
+```
+
+---
+
+## CLI Usage
+
+```bash
+# Run Check only
+omniship check
+
+# Run Check → Build
+omniship build
+
+# Run Build only (skip Check)
+omniship build --skip-check
+
+# Run full flow: Check → Build → Ship
+omniship ship
+
+# Inspect the execution DAG
+omniship plan
+
+# List registered plugins & operations
+omniship plugins
+
+# View operation details or generate YAML config template
+omniship plugin show core/command
+omniship plugin template core/command
+```

omniship-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[project]
+name = "omniship"
+version = "0.1.0"
+description = "Universal release orchestration"
+readme = "README.md"
+requires-python = ">=3.14"
+dependencies = [
+    "click>=8.5.0",
+    "pydantic>=2.13.5",
+    "pyyaml>=6.0.3",
+    "rich>=15.0.0",
+]
+
+[[project.authors]]
+name = "Ata Sesli"
+
+[project.urls]
+Homepage = "https://github.com/0ctacity/omniship"
+Repository = "https://github.com/0ctacity/omniship"
+Issues = "https://github.com/0ctacity/omniship/issues"
+
+[project.scripts]
+omniship = "omniship.cli.app:cli"
+
+[project.entry-points."omniship.plugins"]
+core = "omniship.operations:register_core_plugin"
+github = "omniship.operations.github:register_github_plugin"
+
+[build-system]
+requires = ["uv_build>=0.12.9,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+]

omniship-0.1.0/pyproject.toml.orig

@@ -0,0 +1,36 @@
+[project]
+name = "omniship"
+version = "0.1.0"
+description = "Universal release orchestration"
+readme = "README.md"
+authors = [
+    { name = "Ata Sesli" }
+]
+requires-python = ">=3.14"
+dependencies = [
+    "click>=8.5.0",
+    "pydantic>=2.13.5",
+    "pyyaml>=6.0.3",
+    "rich>=15.0.0",
+]
+[project.urls]
+Homepage = "https://github.com/0ctacity/omniship"
+Repository = "https://github.com/0ctacity/omniship"
+Issues = "https://github.com/0ctacity/omniship/issues"
+
+[project.scripts]
+omniship = "omniship.cli.app:cli"
+
+[project.entry-points."omniship.plugins"]
+core = "omniship.operations:register_core_plugin"
+github = "omniship.operations.github:register_github_plugin"
+
+[build-system]
+requires = ["uv_build>=0.12.9,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+]

omniship-0.1.0/src/omniship/__init__.py

@@ -0,0 +1,2 @@
+def main() -> None:
+    print("Hello from omniship!")

omniship-0.1.0/src/omniship/cli/app.py

@@ -0,0 +1,29 @@
+import click
+
+from omniship.cli.build import build_cmd
+from omniship.cli.check import check_cmd
+from omniship.cli.plan import plan_cmd
+from omniship.cli.plugins import plugin_cmd, plugins_cmd
+from omniship.cli.ship import ship_cmd
+
+
+@click.group()
+def cli() -> None:
+    """OmniShip: Next-generation release & build DAG executor."""
+    pass
+
+
+cli.add_command(check_cmd, name="check")
+cli.add_command(build_cmd, name="build")
+cli.add_command(ship_cmd, name="ship")
+cli.add_command(plan_cmd, name="plan")
+cli.add_command(plugins_cmd, name="plugins")
+cli.add_command(plugin_cmd, name="plugin")
+
+
+def main() -> None:
+    cli()
+
+
+if __name__ == "__main__":
+    main()

omniship-0.1.0/src/omniship/cli/build.py

@@ -0,0 +1,16 @@
+import sys
+import click
+
+from omniship.cli.runner import run_pipeline
+from omniship.core.stage import Stage
+
+
+@click.command()
+@click.option("--skip-check", is_flag=True, default=False, help="Skip the Check stage")
+@click.option("-c", "--config", "config_path", help="Path to configuration file")
+def build_cmd(skip_check: bool, config_path: str | None) -> None:
+    """Run Check -> Build (or only Build if --skip-check)."""
+    stages = [Stage.BUILD] if skip_check else [Stage.CHECK, Stage.BUILD]
+    code = run_pipeline(stages, config_path=config_path)
+    if code != 0:
+        sys.exit(code)

omniship-0.1.0/src/omniship/cli/check.py

@@ -0,0 +1,14 @@
+import sys
+import click
+
+from omniship.cli.runner import run_pipeline
+from omniship.core.stage import Stage
+
+
+@click.command()
+@click.option("-c", "--config", "config_path", help="Path to configuration file")
+def check_cmd(config_path: str | None) -> None:
+    """Run only the Check stage."""
+    code = run_pipeline([Stage.CHECK], config_path=config_path)
+    if code != 0:
+        sys.exit(code)

omniship-0.1.0/src/omniship/cli/plan.py

@@ -0,0 +1,65 @@
+import sys
+from pathlib import Path
+import click
+from rich.console import Console
+from rich.tree import Tree
+
+from omniship.config.loader import find_config_file, load_and_validate
+from omniship.core.graph import StageGraph
+from omniship.core.stage import Stage
+from omniship.plugins.discovery import load_plugins
+
+
+def print_plan(graphs: dict[Stage, StageGraph], console: Console | None = None) -> None:
+    console = console or Console()
+
+    console.print("[bold]OmniShip Execution Plan[/bold]\n")
+
+    for stage in (Stage.CHECK, Stage.BUILD, Stage.SHIP):
+        graph = graphs.get(stage)
+        console.print(f"[bold cyan]{stage.value.upper()}[/bold cyan]")
+        if not graph or not graph.nodes:
+            console.print("  [dim](empty)[/dim]\n")
+            continue
+
+        roots = graph.get_roots()
+        if roots:
+            for root in sorted(roots, key=lambda n: n.id):
+                root_tree = Tree(f"[bold]{root.id}[/bold] [dim]({root.operation_name})[/dim]")
+                _add_children(root.id, root_tree, graph, set())
+                console.print(root_tree)
+        else:
+            for node_id, node in sorted(graph.nodes.items()):
+                console.print(f"  • {node_id} [dim]({node.operation_name})[/dim]")
+        console.print()
+
+
+def _add_children(node_id: str, tree: Tree, graph: StageGraph, visited: set[str]) -> None:
+    if node_id in visited:
+        return
+    visited.add(node_id)
+    dependents = sorted(graph.get_direct_dependents(node_id))
+    for dep_id in dependents:
+        node = graph.nodes[dep_id]
+        branch = tree.add(f"[bold]{node.id}[/bold] [dim]({node.operation_name})[/dim]")
+        _add_children(dep_id, branch, graph, visited.copy())
+
+
+@click.command(name="plan")
+@click.option("-c", "--config", "config_path", help="Path to configuration file")
+def plan_cmd(config_path: str | None) -> None:
+    """Inspect the execution plan and dependency DAG."""
+    console = Console()
+    registry = load_plugins()
+    path = Path(config_path) if config_path else find_config_file()
+    if not path or not path.is_file():
+        console.print("[bold red]Error:[/bold red] No omniship.yaml configuration file found.")
+        sys.exit(1)
+
+    try:
+        _, graphs = load_and_validate(path, registry)
+    except Exception as exc:
+        console.print(f"[bold red]Configuration Error:[/bold red] {exc}")
+        sys.exit(1)
+
+    print_plan(graphs, console)

omniship-0.1.0/src/omniship/cli/plugins.py

@@ -0,0 +1,73 @@
+import click
+from rich.console import Console
+from rich.table import Table
+
+from omniship.plugins.discovery import load_plugins
+from omniship.plugins.template import generate_operation_template
+
+
+@click.group(name="plugins", invoke_without_command=True)
+@click.pass_context
+def plugins_cmd(ctx: click.Context) -> None:
+    """List available plugins and operations."""
+    if ctx.invoked_subcommand is None:
+        console = Console()
+        registry = load_plugins()
+        ops = registry.list_operations()
+
+        table = Table(title="Registered Operations")
+        table.add_column("Operation", style="bold cyan")
+        table.add_column("Stages", style="green")
+        table.add_column("Cacheable", style="magenta")
+        table.add_column("Description")
+
+        for op in sorted(ops, key=lambda x: x.name):
+            stages_str = ", ".join(s.value for s in sorted(op.stages))
+            table.add_row(
+                op.name,
+                stages_str,
+                "yes" if op.cacheable else "no",
+                op.description,
+            )
+
+        console.print(table)
+
+
+@click.group(name="plugin")
+def plugin_cmd() -> None:
+    """Inspect or generate templates for operations."""
+    pass
+
+
+@plugin_cmd.command(name="show")
+@click.argument("name")
+def plugin_show(name: str) -> None:
+    """Show details for an operation."""
+    console = Console()
+    registry = load_plugins()
+    definition = registry.get_definition(name)
+    if not definition:
+        console.print(f"[bold red]Error:[/bold red] Operation '{name}' not found.")
+        return
+
+    console.print(f"[bold cyan]Operation:[/bold cyan] {definition.name}")
+    console.print(f"[bold]Description:[/bold] {definition.description}")
+    console.print(f"[bold]Allowed Stages:[/bold] {', '.join(s.value for s in definition.stages)}")
+    console.print(f"[bold]Cacheable:[/bold] {'yes' if definition.cacheable else 'no'}")
+    if definition.config_model:
+        console.print("\n[bold]Configuration Template:[/bold]")
+        console.print(generate_operation_template(definition))
+
+
+@plugin_cmd.command(name="template")
+@click.argument("name")
+def plugin_template(name: str) -> None:
+    """Generate example YAML configuration for an operation."""
+    console = Console()
+    registry = load_plugins()
+    definition = registry.get_definition(name)
+    if not definition:
+        console.print(f"[bold red]Error:[/bold red] Operation '{name}' not found.")
+        return
+
+    console.print(generate_operation_template(definition), end="")

omniship-0.1.0/src/omniship/cli/runner.py

@@ -0,0 +1,68 @@
+import asyncio
+from pathlib import Path
+
+from rich.console import Console
+
+from omniship.cli.ui import TerminalUI
+from omniship.config.loader import find_config_file, load_and_validate
+from omniship.core.context import ExecutionContext
+from omniship.core.executor import StageExecutor
+from omniship.core.stage import Stage
+from omniship.plugins.discovery import load_plugins
+
+
+def run_pipeline(
+    stages_to_run: list[Stage],
+    config_path: str | None = None,
+    console: Console | None = None,
+) -> int:
+    console = console or Console()
+    console.print("[bold]OmniShip v0.1.0[/bold]")
+
+    # 1. Load plugins
+    registry = load_plugins()
+
+    # 2. Locate config
+    path = Path(config_path) if config_path else find_config_file()
+    if not path or not path.is_file():
+        console.print("[bold red]Error:[/bold red] No omniship.yaml configuration file found.")
+        return 1
+
+    # 3. Load & validate configuration
+    try:
+        config, graphs = load_and_validate(path, registry)
+    except Exception as exc:
+        console.print(f"[bold red]Configuration Error:[/bold red] {exc}")
+        return 1
+
+    # 4. Set up context and executor
+    workspace_root = path.parent.resolve()
+    context = ExecutionContext(
+        workspace_root=workspace_root,
+        stage=stages_to_run[0],
+    )
+
+    ui = TerminalUI(console=console)
+    executor = StageExecutor(registry=registry, listeners=[ui])
+
+    async def _execute() -> bool:
+        graphs_to_execute = [graphs[st] for st in stages_to_run if st in graphs]
+        for g in graphs_to_execute:
+            context.stage = g.stage
+            success = await executor.execute_stage(g, context)
+            if g.stage == Stage.BUILD and context.artifacts:
+                ui.print_artifacts(context.artifacts.to_list())
+            if not success:
+                return False
+        return True
+
+    success = asyncio.run(_execute())
+
+    if success:
+        if Stage.SHIP in stages_to_run:
+            console.print("\n[bold green]Shipped successfully![/bold green]")
+        else:
+            console.print(f"\n[bold green]{stages_to_run[-1].value.capitalize()} completed successfully![/bold green]")
+        return 0
+    else:
+        return 1

omniship-0.1.0/src/omniship/cli/ship.py

@@ -0,0 +1,23 @@
+import sys
+import click
+
+from omniship.cli.runner import run_pipeline
+from omniship.core.stage import Stage
+
+
+@click.command()
+@click.option("--skip-check", is_flag=True, default=False, help="Skip the Check stage")
+@click.option("--skip-build", is_flag=True, default=False, help="Skip the Build stage")
+@click.option("-c", "--config", "config_path", help="Path to configuration file")
+def ship_cmd(skip_check: bool, skip_build: bool, config_path: str | None) -> None:
+    """Run Check -> Build -> Ship (complete release flow)."""
+    stages: list[Stage] = []
+    if not skip_check:
+        stages.append(Stage.CHECK)
+    if not skip_build:
+        stages.append(Stage.BUILD)
+    stages.append(Stage.SHIP)
+
+    code = run_pipeline(stages, config_path=config_path)
+    if code != 0:
+        sys.exit(code)

omniship-0.1.0/src/omniship/cli/ui.py

@@ -0,0 +1,57 @@
+from rich.console import Console
+
+from omniship.core.graph import StageGraph
+from omniship.core.node import Node
+from omniship.core.result import NodeResult, NodeStatus
+from omniship.core.stage import Stage
+
+
+class TerminalUI:
+    def __init__(self, console: Console | None = None) -> None:
+        self.console = console or Console()
+        self._current_stage: Stage | None = None
+        self._stage_failed = False
+        self._printed_stages: set[Stage] = set()
+
+    def on_stage_start(self, stage: Stage, graph: StageGraph) -> None:
+        self._current_stage = stage
+        self.console.print()
+        self.console.print(f"[bold cyan]{stage.value.upper()}[/bold cyan]")
+        if not graph.nodes:
+            self.console.print("  [dim](no nodes defined)[/dim]")
+
+    def on_node_start(self, stage: Stage, node: Node) -> None:
+        pass
+
+    def on_node_finish(self, stage: Stage, node: Node, result: NodeResult) -> None:
+        if result.status == NodeStatus.SUCCESS:
+            dur = f"{result.duration:.2f}s"
+            self.console.print(f"  [green]✓[/green] [bold]{node.id:<24}[/bold] [dim]{dur:>8}[/dim]")
+        elif result.status == NodeStatus.SKIPPED:
+            reason = result.error_message or "skipped"
+            self.console.print(f"  [yellow]⊘[/yellow] [bold]{node.id:<24}[/bold] [yellow]{reason}[/yellow]")
+        elif result.status == NodeStatus.FAILED:
+            dur = f"{result.duration:.2f}s"
+            self.console.print(f"  [red]✗[/red] [bold]{node.id:<24}[/bold] [red]{dur:>8}[/red]")
+            if result.error_message:
+                self.console.print(f"    [red]Error:[/red] {result.error_message}")
+            if result.stdout.strip():
+                self.console.print("    [dim]--- stdout ---[/dim]")
+                for line in result.stdout.strip().splitlines():
+                    self.console.print(f"    {line}")
+            if result.stderr.strip():
+                self.console.print("    [dim]--- stderr ---[/dim]")
+                for line in result.stderr.strip().splitlines():
+                    self.console.print(f"    [red]{line}[/red]")
+
+    def on_stage_finish(self, stage: Stage, success: bool) -> None:
+        if not success:
+            self._stage_failed = True
+            self.console.print(f"\n[bold red]{stage.value.upper()} FAILED[/bold red]")
+
+    def print_artifacts(self, artifacts: list) -> None:
+        if artifacts:
+            self.console.print()
+            self.console.print("[bold]Artifacts[/bold]")
+            for art in artifacts:
+                self.console.print(f"  [green]•[/green] {art.name} [dim]({art.path})[/dim]")