hap-cli 0.8.9__tar.gz → 0.8.10__tar.gz

{hap_cli-0.8.9 → hap_cli-0.8.10}/MANIFEST.in

@@ -15,4 +15,4 @@ recursive-include hap_cli/locale *.json
 # edit-spec schemas are canonical in the hap-cli-app-editor skill; ship them
 # in the sdist so setup.py's build step can mirror them into
 # hap_cli/core/editor/editspec/ for the ``hap app-editor`` runtime loader.
-recursive-include skills/hap-cli-app-editor/scripts/editspec *.json
+recursive-include skills/cli/hap-cli-app-editor/scripts/editspec *.json

{hap_cli-0.8.9 → hap_cli-0.8.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hap-cli
-Version: 0.8.9
+Version: 0.8.10
 Summary: CLI harness for MingDAO HAP - Enterprise no-code platform
 Author: hap-cli
 License: Apache-2.0

{hap_cli-0.8.9 → hap_cli-0.8.10}/hap_cli/__init__.py

@@ -1,3 +1,3 @@
 """CLI harness for MingDAO HAP (hap-cli)."""
 
-__version__ = "0.8.9"
+__version__ = "0.8.10"

hap_cli-0.8.10/hap_cli/commands/app_creator_cmd.py

@@ -0,0 +1,137 @@
+"""CLI commands for building a whole HAP app from a design document
+(``hap app-creator``).
+
+Thin Click layer over the app-creator engine in
+``hap_cli.core.app_creator``: validate a design locally, build the whole
+app end-to-end, merge split design parts, and seed sample data. The engine
+is an ID-free, logical-name design compiler — it turns one design document
+into a real app (worksheets, views, roles, workflows, pages, AI assistants)
+and captures every created id beside the design file.
+
+Each subcommand is a thin wrapper: it reconstructs the argument list the
+engine entry point expects and delegates, propagating the engine's exit
+code. The engine streams its own progress and writes a run report next to
+the design document; that rich console output IS the command's output, so
+these commands are human-oriented and do not reshape their result for
+``--json`` mode. (Every call the engine makes back into the ``hap`` CLI is
+its own isolated ``--json`` invocation — see ``core/app_creator/hap.py``.)
+"""
+import click
+
+from hap_cli.core.app_creator import cleanup as cleanup_mod
+from hap_cli.core.app_creator import merge as merge_mod
+from hap_cli.core.app_creator import smoke as build_mod
+from hap_cli.core.app_creator import validate as validate_mod
+from hap_cli.core.app_creator.seed import cli as seed_cli
+
+
+@click.group("app-creator", help="Build a complete HAP app from a design "
+                                 "document — validate, build, and seed.")
+def app_creator():
+    pass
+
+
+@app_creator.command("validate")
+@click.argument("designs", nargs=-1, required=True,
+                type=click.Path(exists=True, dir_okay=False))
+def app_creator_validate(designs):
+    """Validate one or more design documents locally before building.
+
+    Checks structure (required fields, enums, types, relation display
+    modes) and confirms every icon is a real catalogue icon. Multiple
+    files are merged into one document first, so cross-file references by
+    logical name are checked too. No app is created.
+    """
+    raise SystemExit(validate_mod.main(list(designs)))
+
+
+@app_creator.command("build")
+@click.argument("designs", nargs=-1, required=True,
+                type=click.Path(exists=True, dir_okay=False))
+def app_creator_build(designs):
+    """Build a whole app end-to-end from one or more design documents.
+
+    Runs once, start to finish: multiple files are merged first, then the
+    app and all its elements are created against your current organization.
+    A step that fails mid-run is recorded and the build keeps going; the
+    created app is kept. Prints the new app id and writes a run report next
+    to the design document.
+    """
+    raise SystemExit(build_mod.main(list(designs)))
+
+
+@app_creator.command("merge")
+@click.argument("parts", nargs=-1, required=True,
+                type=click.Path(exists=True, dir_okay=False))
+@click.option("--out", "out", required=True,
+              type=click.Path(dir_okay=False),
+              help="Path to write the merged design document.")
+def app_creator_merge(parts, out):
+    """Merge several design parts into one combined design document.
+
+    Validates the combined document as a whole before writing it. Use this
+    when you want the merged file saved to disk; build and validate already
+    accept multiple parts directly.
+    """
+    raise SystemExit(merge_mod.main([*parts, "--out", out]))
+
+
+@app_creator.command("seed-template")
+@click.argument("app_id")
+@click.option("--out", "out", type=click.Path(dir_okay=False),
+              help="Output path for the fill template "
+                   "(default: the app's design folder).")
+def app_creator_seed_template(app_id, out):
+    """Emit a sample-data fill template for a built app.
+
+    Reads the app's live worksheet structure and writes a template listing
+    every writable field per worksheet — author your sample data against it,
+    then load it with ``seed``.
+    """
+    argv = [app_id]
+    if out:
+        argv += ["--out", out]
+    raise SystemExit(seed_cli.template_main(argv))
+
+
+@app_creator.command("seed")
+@click.argument("app_id")
+@click.argument("data_file", required=False,
+                type=click.Path(exists=True, dir_okay=False))
+@click.option("--trigger-workflow", is_flag=True, default=False,
+              help="Fire workflows on each created record (off by default).")
+def app_creator_seed(app_id, data_file, trigger_workflow):
+    """Load authored sample data into a built app.
+
+    Writes records worksheet by worksheet in dependency order, resolves
+    cross-record references, and records the created row ids. Defaults to
+    the sample-data file in the app's design folder.
+    """
+    argv = [app_id]
+    if data_file:
+        argv.append(data_file)
+    if trigger_workflow:
+        argv.append("--trigger-workflow")
+    raise SystemExit(seed_cli.seed_main(argv))
+
+
+@app_creator.command("cleanup")
+@click.argument("app_id")
+@click.option("--destroy", is_flag=True, default=False,
+              help="Also delete the local design files (full removal); "
+                   "by default they are kept.")
+@click.option("--yes", "-y", is_flag=True, default=False,
+              help="Skip the confirmation prompt.")
+def app_creator_cleanup(app_id, destroy, yes):
+    """Delete a built app and archive its captured artifacts.
+
+    Deletes the app from your organization. By default the local design
+    files are kept (only generated artifacts are archived) so the app can
+    be rebuilt later; pass ``--destroy`` to remove the design folder too.
+    """
+    argv = [app_id]
+    if destroy:
+        argv.append("--destroy")
+    if yes:
+        argv.append("--yes")
+    raise SystemExit(cleanup_mod.main(argv))

hap_cli-0.8.10/hap_cli/core/app_creator/_hapmeta/__init__.py

@@ -0,0 +1,10 @@
+"""Vendored, stdlib-only copies of the two hap_cli helpers the build
+pipeline needs to construct field-control wire payloads locally.
+
+The published skill must NOT depend on the ``hap_cli`` Python package being
+importable — it may only shell out to the ``hap`` binary and run its own
+bundled files. These modules are byte-faithful copies of
+``hap_cli/core/control_type_codes.py`` and
+``hap_cli/core/worksheet_templates.py`` with their one cross-module import
+made relative. Keep them in sync if the upstream wire format changes.
+"""