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

{hap_cli-0.8.8 → 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.8 → hap_cli-0.8.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hap-cli
-Version: 0.8.8
+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.8 → hap_cli-0.8.10}/hap_cli/__init__.py

@@ -1,3 +1,3 @@
 """CLI harness for MingDAO HAP (hap-cli)."""
 
-__version__ = "0.8.8"
+__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.8 → hap_cli-0.8.10}/hap_cli/commands/chart_cmd.py

@@ -22,12 +22,14 @@ def chart():
 
 
 # Report-type enum values used by the MingDAO statistics module. The CLI
-# accepts the integer directly so users can pass uncommon types (sankey,
-# treemap, etc.) without us having to enumerate every one.
+# accepts the integer directly so users can pass uncommon types without us
+# having to enumerate every one. Note: there is NO type 4 — passing 4 is
+# coerced to 10 (number) by the server, so it is omitted here (bug #036584).
 _REPORT_TYPE_HINT = (
-    "Chart type (integer). Common values: "
-    "1=column, 2=line, 3=pie, 4=number, 5=bar, 6=radar, 7=funnel, "
-    "8=dual-axis, 9=pivot, 10=heatmap."
+    "Chart type (integer). Values: "
+    "1=column, 2=line, 3=pie, 5=radar, 6=funnel, 7=dual-axis, 8=pivot, "
+    "9=region-map, 10=number, 11=bidirectional-bar, 12=scatter, "
+    "13=word-cloud, 14=gauge, 15=progress, 16=ranking, 17=world-map."
 )
 
 

{hap_cli-0.8.8 → hap_cli-0.8.10}/hap_cli/commands/chatbot_cmd.py

@@ -120,7 +120,8 @@ def chatbot_rename(ctx, app_id, chatbot_id, section_id, name, icon):
 @click.option("--app-id", "-a", required=True, help="Application ID")
 @org_id_option()
 @click.option("--section-id", default="",
-              help="Section/group the assistant lives under. Optional.")
+              help="Section/group the assistant lives under. Auto-detected "
+                   "when omitted.")
 @click.option("--permanent", is_flag=True, default=False,
               help="Delete permanently instead of moving to the recycle bin.")
 @click.option("--yes", "-y", is_flag=True, help="Skip confirmation")

{hap_cli-0.8.8 → hap_cli-0.8.10}/hap_cli/commands/record_cmd.py

@@ -156,9 +156,12 @@ def record_update(ctx, worksheet_id, row_id, field, fields_json, no_workflow):
     Pass values either as repeated -f CONTROL_ID=VALUE pairs or as one
     --fields-json array.
 
-    A sub-table value is the full list of child rows (each a dict keyed
-    by child field name) and replaces the existing rows; an empty list
-    clears the sub-table.
+    A sub-table value is a list of child rows, each a dict keyed by child
+    field name. Updates are incremental: a child row with a "rowid" key
+    edits that existing row in place (its id is kept and only the listed
+    fields change), a child row without a "rowid" adds a new row, and a
+    child row with "_delete": true removes that row. Rows you don't list
+    are left untouched. An empty list (or null) clears the sub-table.
     """
     if field and fields_json:
         raise click.UsageError("Pass exactly one of -f or --fields-json.")

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.
+"""