kcreate-scaffolding-gcp-script 0.0.0-stage → 0.2.0

package/vendor/github-proyect-tracking/scripts/tracking.py

@@ -0,0 +1,196 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""CLI de github-proyect-tracking; un JSON por comando, stdlib únicamente."""
+
+from __future__ import annotations
+
+import argparse
+import shutil
+import sys
+
+from tracking_core import github as _github
+from tracking_core.common import *  # noqa: F401,F403
+from tracking_core.events import *  # noqa: F401,F403
+from tracking_core.state import *  # noqa: F401,F403
+from tracking_core.commands import *  # noqa: F401,F403
+
+_raw_api = _github._raw_api
+
+
+def _sync_runtime():
+    _github._raw_api = _raw_api
+    _github.shutil = shutil
+    _github.MAX_COMMENT_PAGES = MAX_COMMENT_PAGES
+    StateLock.STALE_SECONDS = LOCK_STALE_SECONDS
+    StateLock.WAIT_SECONDS = LOCK_WAIT_SECONDS
+
+
+def api(method, path, token, body=None, retries=3):
+    _sync_runtime()
+    return _github.api(method, path, token, body, retries)
+
+
+def check_issues_write(owner, repo, token):
+    _sync_runtime()
+    return _github.check_issues_write(owner, repo, token)
+
+
+def resolve_token(cli_token=None, state=None):
+    _sync_runtime()
+    return _github.resolve_token(cli_token, state)
+
+
+def post_comment(owner, repo, number, body, token,
+                 baseline_ids=None, execution_id=None, sequence=None):
+    _sync_runtime()
+    return _github.post_comment(owner, repo, number, body, token,
+                                baseline_ids, execution_id, sequence)
+
+
+def fetch_issue(owner, repo, number, token):
+    _sync_runtime()
+    return _github.fetch_issue(owner, repo, number, token)
+
+
+def fetch_all_comments(owner, repo, number, token):
+    _sync_runtime()
+    return _github.fetch_all_comments(owner, repo, number, token)
+
+
+def close_issue(owner, repo, number, token):
+    _sync_runtime()
+    return _github.close_issue(owner, repo, number, token)
+
+
+def find_issue_by_title(owner, repo, title, token):
+    _sync_runtime()
+    return _github.find_issue_by_title(owner, repo, title, token)
+
+
+class JsonArgumentParser(argparse.ArgumentParser):
+    def error(self, message):
+        raise SkillError(EXIT_VALIDATION, "VALIDATION_ERROR",
+                         f"argumentos inválidos: {message}")
+
+
+def build_parser():
+    parser = JsonArgumentParser(
+        prog="tracking.py",
+        description="github-proyect-tracking: persiste y reanuda el estado de un "
+                    "proceso en GitHub Issues. Cada comando imprime un único JSON.")
+    parser.add_argument("--version", action="version", version=USER_AGENT)
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    def common(subparser, with_url=True, url_required=False):
+        if with_url:
+            subparser.add_argument(
+                "--url", required=url_required, metavar="URL",
+                help="github_project_url (https://github.com/{owner}/{repo}); "
+                     "obligatorio si hay varios procesos activos")
+        subparser.add_argument("--token", default=None, metavar="T",
+                               help="GitHub PAT con issues:write (si se omite: "
+                                    "env/gh/estado)")
+
+    subparser = subparsers.add_parser(
+        "init", help="nueva ejecución: valida, crea el Issue y guarda memoria")
+    common(subparser, url_required=True)
+    subparser.add_argument("--plan", default=None, metavar="JSON",
+                           help='plan de pasos con nombres ÚNICOS, ej. \'["Paso 1","Paso 2"]\'')
+    subparser.add_argument("--plan-file", default=None, metavar="F",
+                           help="archivo JSON con la lista de pasos")
+    subparser.add_argument("--prompt-token", action="store_true",
+                           help="pedir el token interactivamente (TTY)")
+    subparser.add_argument("--store-token", action="store_true",
+                           help="persistir el token provisto (opt-in; por defecto NO se guarda)")
+    subparser.add_argument("--no-store-token", action="store_true",
+                           help="obsoleto (compatibilidad): ahora NO guardar es el default")
+    subparser.set_defaults(func=cmd_init)
+
+    subparser = subparsers.add_parser(
+        "resume", help="lee el último comentario del Issue y planea la reanudación")
+    common(subparser)
+    subparser.set_defaults(func=cmd_resume)
+
+    subparser = subparsers.add_parser(
+        "step-start", help="comenta [STATUS: INICIANDO] - Paso: N")
+    common(subparser)
+    subparser.add_argument("--name", required=True, metavar="N", help="nombre del paso")
+    subparser.set_defaults(func=cmd_step_start)
+
+    subparser = subparsers.add_parser(
+        "step-done", help="comenta [STATUS: COMPLETADO] - Paso: N")
+    common(subparser)
+    subparser.add_argument("--name", required=True, metavar="N", help="nombre del paso")
+    subparser.set_defaults(func=cmd_step_done)
+
+    subparser = subparsers.add_parser(
+        "step-error", help="comenta [STATUS: ERROR] y detiene el proceso")
+    common(subparser)
+    subparser.add_argument("--name", required=True, metavar="N", help="nombre del paso")
+    subparser.add_argument("--details", default=None, metavar="D",
+                           help="mensaje de error o stacktrace (se sanitiza antes de publicar)")
+    subparser.add_argument("--details-file", default=None, metavar="F",
+                           help="archivo con el error/stacktrace")
+    subparser.set_defaults(func=cmd_step_error)
+
+    subparser = subparsers.add_parser(
+        "finalize", help="cierra el Issue con resultado FINALIZADO o CANCELADO")
+    common(subparser)
+    subparser.add_argument("--force", action="store_true",
+                           help="cancelar aunque queden pasos pendientes o no haya trabajo "
+                                "(no aplica si el Issue fue cerrado externamente)")
+    subparser.set_defaults(func=cmd_finalize)
+
+    subparser = subparsers.add_parser(
+        "status", help="muestra el estado local (y remoto con --remote)")
+    common(subparser)
+    subparser.add_argument("--remote", action="store_true",
+                           help="consultar también el Issue en GitHub")
+    subparser.set_defaults(func=cmd_status)
+
+    subparser = subparsers.add_parser(
+        "adopt", help="recupera el estado local desde un Issue remoto")
+    common(subparser, url_required=True)
+    subparser.add_argument("--execution-id", required=True, metavar="ID",
+                           help="Execution ID EXACTO del título del Issue")
+    subparser.add_argument("--force", action="store_true",
+                           help="reemplazar un proceso activo existente (conserva token "
+                                "e historial)")
+    subparser.set_defaults(func=cmd_adopt)
+
+    subparser = subparsers.add_parser(
+        "clear", help="limpia la memoria interna (soft por defecto)")
+    common(subparser)
+    subparser.add_argument("--hard", action="store_true",
+                           help="eliminar el archivo de estado por completo")
+    subparser.set_defaults(func=cmd_clear)
+
+    subparser = subparsers.add_parser(
+        "doctor", help="diagnóstico del entorno (siempre exit 0)")
+    common(subparser)
+    subparser.set_defaults(func=cmd_doctor)
+    return parser
+
+
+def main(argv=None):
+    try:
+        args = build_parser().parse_args(argv)
+        _sync_runtime()
+        return args.func(args)
+    except SkillError as error:
+        emit(error.to_json())
+        return error.exit_code
+    except KeyboardInterrupt:
+        return 130
+    except SystemExit:
+        raise
+    except Exception as error:
+        emit({"ok": False, "error": {
+            "code": "UNEXPECTED",
+            "message": f"{type(error).__name__}: {error}",
+            "hint": "error no previsto; reporta el comando exacto y este JSON"}})
+        return EXIT_RUNTIME
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/vendor/github-proyect-tracking/scripts/tracking_core/__init__.py

@@ -0,0 +1 @@
+"""Componentes internos de github-proyect-tracking."""