runspec-logops 0.1.0__py3-none-any.whl

runspec_logops/__init__.py

@@ -0,0 +1,21 @@
+"""runspec-logops — log-condensing + code-mapping runnables.
+
+The pure logic lives in the dependency-free ``runspec-logops-core`` package; the
+modules here wrap each helper in a runspec runnable. The helper functions are
+re-exported for convenience and back-compat (e.g. ``from runspec_logops import
+summarize_log``). To import the helpers *without* surfacing any runnables in a
+venv — the corporate-wrapping path — depend on ``runspec-logops-core`` directly
+instead.
+"""
+
+from runspec_logops_core import (
+    build_bundle,
+    map_trace_to_sources,
+    summarize_log,
+)
+
+__all__ = [
+    "summarize_log",
+    "map_trace_to_sources",
+    "build_bundle",
+]

runspec_logops/bundle.py

@@ -0,0 +1,30 @@
+import json
+import sys
+
+import runspec as rs
+from runspec_logops_core import build_bundle, map_trace_to_sources, summarize_log
+from runspec_logops_core.errors import SourceNotFoundError
+
+
+def main_bundle_digest() -> None:
+    spec = rs.parse("bundle-digest")
+    file_path = str(spec.file)
+    # Unset optionals resolve to an Arg wrapping value None; read .value so the
+    # absent case is a real None rather than the string "None".
+    repo = str(spec.repo) if spec.repo.value is not None else None
+    trace = str(spec.trace) if spec.trace.value is not None else None
+    destination = str(spec.destination)
+    top = int(spec.top)
+    try:
+        digest = summarize_log(file_path, top=top)
+        code_map = None
+        if trace and repo:
+            code_map = map_trace_to_sources(repo, trace)
+        result = build_bundle(digest, code_map, dest_dir=destination, metadata={"trace": trace})
+        print(json.dumps(result))
+    except SourceNotFoundError as e:
+        print(json.dumps({"error": str(e), "file": file_path}))
+        sys.exit(1)
+    except OSError as e:
+        print(json.dumps({"error": str(e), "file": file_path}))
+        sys.exit(1)

runspec_logops/codemap.py

@@ -0,0 +1,23 @@
+import json
+import sys
+
+import runspec as rs
+from runspec_logops_core import map_trace_to_sources
+from runspec_logops_core.errors import SourceNotFoundError
+
+
+def main_map_trace() -> None:
+    spec = rs.parse("map-trace")
+    repo = str(spec.repo)
+    trace = str(spec.trace)
+    context = int(spec.context)
+    max_files = int(spec.max_files)
+    try:
+        result = map_trace_to_sources(repo, trace, context=context, max_files=max_files)
+        print(json.dumps(result))
+    except SourceNotFoundError as e:
+        print(json.dumps({"error": str(e), "repo": repo}))
+        sys.exit(1)
+    except OSError as e:
+        print(json.dumps({"error": str(e), "repo": repo}))
+        sys.exit(1)

runspec_logops/digest.py

@@ -0,0 +1,34 @@
+import json
+import sys
+
+import runspec as rs
+from runspec_logops_core import summarize_log
+from runspec_logops_core.errors import SourceNotFoundError
+
+
+def main_summarize_log() -> None:
+    spec = rs.parse("summarize-log")
+    file_path = str(spec.file)
+    level = str(spec.level)
+    # Unset optionals resolve to an Arg wrapping value None; read .value so the
+    # absent case is a real None rather than the string "None".
+    since = spec.since.value
+    until = spec.until.value
+    top = int(spec.top)
+    max_sample_lines = int(spec.max_sample_lines)
+    try:
+        digest = summarize_log(
+            file_path,
+            level=level,
+            since=since,
+            until=until,
+            top=top,
+            max_sample_lines=max_sample_lines,
+        )
+        print(json.dumps(digest))
+    except SourceNotFoundError as e:
+        print(json.dumps({"error": str(e), "file": file_path}))
+        sys.exit(1)
+    except OSError as e:
+        print(json.dumps({"error": str(e), "file": file_path}))
+        sys.exit(1)

runspec_logops/runspec.toml

@@ -0,0 +1,111 @@
+[config]
+autonomy-default = "autonomous"
+
+[config.logging]
+# Per-invocation log files: one {runnable}.{utc-ts}.{run_id}.log per run.
+# Multi-writer safe for shared venvs (use `runspec logs` to view/compact/prune).
+store = "per-run"
+
+# ── Log condensing ─────────────────────────────────────────────────────────────
+
+[summarize-log]
+serve       = ["local"]
+description = "Condense a log file into a small digest: cluster repeated errors by signature and return the top-N distinct issues with counts, first/last timestamp and one sample each. The digest size is bounded regardless of how big the log is, so read this instead of the raw log."
+autonomy    = "autonomous"
+output      = "json"
+
+[summarize-log.args.file]
+type        = "path"
+short       = "-f"
+description = "Path to the log file to summarise"
+
+[summarize-log.args.level]
+type        = "choice"
+options     = ["all", "warning", "error", "critical"]
+default     = "all"
+description = "Only include events at or above this severity"
+
+[summarize-log.args.since]
+type        = "str"
+required    = false
+description = "Window start: ISO timestamp, 'now', or '<n> <unit> ago' (e.g. '2 hours ago')"
+
+[summarize-log.args.until]
+type        = "str"
+required    = false
+description = "Window end: ISO timestamp, 'now', or '<n> <unit> ago'"
+
+[summarize-log.args.top]
+type        = "int"
+short       = "-n"
+default     = 10
+description = "Number of distinct signatures to return (most frequent first)"
+
+[summarize-log.args.max-sample-lines]
+type        = "int"
+default     = 20
+description = "Max lines of the sample kept per signature"
+
+# ── Trace → code ────────────────────────────────────────────────────────────────
+
+[map-trace]
+serve       = ["local"]
+description = "Map a stack trace (or a summarize-log signature like 'NullPointerException@com.acme.OrderSvc.price') to the few relevant source snippets in a checkout. Returns only the lines around each frame, never the whole repo."
+autonomy    = "autonomous"
+output      = "json"
+
+[map-trace.args.repo]
+type        = "path"
+short       = "-r"
+description = "Path to the source checkout to search"
+
+[map-trace.args.trace]
+type        = "str"
+short       = "-t"
+description = "The stack trace text, or a signature emitted by summarize-log"
+
+[map-trace.args.context]
+type        = "int"
+default     = 8
+description = "Lines of context to include around each resolved frame"
+
+[map-trace.args.max-files]
+type        = "int"
+default     = 5
+description = "Maximum number of frames/files to resolve"
+
+# ── Bundle for transfer ─────────────────────────────────────────────────────────
+
+[bundle-digest]
+serve       = ["local"]
+description = "Summarise a log and (optionally) map a trace to code, then pack the digest + snippets + manifest into one small zip ready for transfer to the local machine. Writes a file."
+autonomy    = "confirm"
+output      = "json"
+
+[bundle-digest.args.file]
+type        = "path"
+short       = "-f"
+description = "Path to the log file"
+
+[bundle-digest.args.repo]
+type        = "path"
+short       = "-r"
+required    = false
+description = "Path to the source checkout for the optional code map (omit for a digest-only bundle)"
+
+[bundle-digest.args.trace]
+type        = "str"
+required    = false
+description = "Optional trace/signature to map to code; omit for a digest-only bundle"
+
+[bundle-digest.args.destination]
+type        = "path"
+short       = "-d"
+default     = "/tmp"
+description = "Directory to write the zip into"
+
+[bundle-digest.args.top]
+type        = "int"
+short       = "-n"
+default     = 10
+description = "Number of distinct signatures to include in the digest"

runspec_logops-0.1.0.dist-info/METADATA

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: runspec-logops
+Version: 0.1.0
+Summary: Log-condensing + code-mapping runnables for runspec — cheap application-support triage from a log file
+Requires-Python: >=3.10
+Requires-Dist: runspec-logops-core>=0.1.0
+Requires-Dist: runspec>=0.27.0
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'

runspec_logops-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+runspec_logops/__init__.py,sha256=1xs3HfbVgKYTioywOmbkTzSrwiA3fg4ATtgaFA4AtDk,662
+runspec_logops/bundle.py,sha256=xV2tDfH3whI4s9Qd_sAsbZym1Gb2hCg9DwkBtZy9edk,1164
+runspec_logops/codemap.py,sha256=pchw4dhXJdFTvmw2KCz20BGQiI5ij7D3MuzGciQyans,696
+runspec_logops/digest.py,sha256=Dh4s6kfXyQtU7leqZcvCnBvR6rerXNvSxNnrxMAlFFE,1039
+runspec_logops/runspec.toml,sha256=I9tlQEPQNKWhJN0bVoROfxi2zzatO3gxtKqjhu5ArMs,3980
+runspec_logops-0.1.0.dist-info/METADATA,sha256=sXVPEMa04dxCASZ039caTiBhz_awsCdju-2OCBxw9aQ,404
+runspec_logops-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+runspec_logops-0.1.0.dist-info/entry_points.txt,sha256=3V6ebdsUUmmbQZT-EN53sLXwKnu-aOSpug7oD_kIA6s,182
+runspec_logops-0.1.0.dist-info/RECORD,,

runspec_logops-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

runspec_logops-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+bundle-digest = runspec_logops.bundle:main_bundle_digest
+map-trace = runspec_logops.codemap:main_map_trace
+summarize-log = runspec_logops.digest:main_summarize_log