feat: add devsper CLI entry point and restructure as devsper._core extension

Author: rithulkamesh

crates/devsper-py/Cargo.toml

@@ -8,7 +8,7 @@ repository.workspace = true
 homepage.workspace = true
 
 [lib]
-name = "devsper"
+name = "_core"
 crate-type = ["cdylib"]
 
 [dependencies]

crates/devsper-py/src/lib.rs

@@ -440,7 +440,7 @@ fn run_specs_async<'py>(
 // ── Module registration ───────────────────────────────────────────────────────
 
 #[pymodule]
-fn devsper(m: &Bound<'_, PyModule>) -> PyResult<()> {
+fn _core(m: &Bound<'_, PyModule>) -> PyResult<()> {
     m.add_class::<PyNodeSpec>()?;
     m.add_class::<PyWorkflowIr>()?;
     m.add_function(wrap_pyfunction!(run, m)?)?;

python/devsper/__init__.py

@@ -0,0 +1,23 @@
+from devsper._core import (
+    NodeSpec,
+    WorkflowIr,
+    load_workflow,
+    run,
+    run_async,
+    run_specs,
+    run_specs_async,
+    run_workflow,
+    run_workflow_async,
+)
+
+__all__ = [
+    "NodeSpec",
+    "WorkflowIr",
+    "load_workflow",
+    "run",
+    "run_async",
+    "run_specs",
+    "run_specs_async",
+    "run_workflow",
+    "run_workflow_async",
+]

python/devsper/_cli.py

@@ -0,0 +1,42 @@
+import argparse
+import json
+import sys
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="devsper",
+        description="Devsper — self-evolving AI workflow engine",
+    )
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    run_p = sub.add_parser("run", help="Run a .devsper workflow")
+    run_p.add_argument("spec", help="Path to .devsper file")
+    run_p.add_argument(
+        "--input",
+        metavar="KEY=VALUE",
+        action="append",
+        default=[],
+        dest="inputs",
+        help="Workflow input (repeatable)",
+    )
+
+    args = parser.parse_args()
+
+    if args.command == "run":
+        inputs: dict[str, str] = {}
+        for kv in args.inputs:
+            if "=" not in kv:
+                print(f"error: expected KEY=VALUE, got '{kv}'", file=sys.stderr)
+                sys.exit(1)
+            k, v = kv.split("=", 1)
+            inputs[k] = v
+
+        from devsper._core import run as _run
+
+        results = _run(args.spec, inputs or None)
+        print(json.dumps(results, indent=2))
+
+
+if __name__ == "__main__":
+    main()

python/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "devsper"
-version = "3.1.2"
+version = "3.1.3"
 description = "Devsper — self-evolving AI workflow engine"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -18,7 +18,11 @@ classifiers = [
 ]
 dependencies = []
 
+[project.scripts]
+devsper = "devsper._cli:main"
+
 [tool.maturin]
 bindings = "pyo3"
+module-name = "devsper._core"
 manifest-path = "../crates/devsper-py/Cargo.toml"
 strip = true