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

{hap_cli-0.8.9 → hap_cli-0.8.11}/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.11}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: hap-cli
-Version: 0.8.9
-Summary: CLI harness for MingDAO HAP - Enterprise no-code platform
+Version: 0.8.11
+Summary: CLI harness for Mingdao HAP - Enterprise no-code platform
 Author: hap-cli
 License: Apache-2.0
 Classifier: Development Status :: 3 - Alpha
@@ -29,7 +29,7 @@ Dynamic: summary
 
 # hap-cli
 
-CLI harness for **MingDAO HAP** (明道云) — an enterprise no-code platform.
+CLI harness for **Mingdao HAP** (明道云) — an enterprise no-code platform.
 
 ## Installation
 
@@ -54,7 +54,7 @@ each organization's status (`CLI:on/off`).
 ### 1. Login
 
 ```bash
-# MingDAO SaaS (default)
+# Mingdao SaaS (default)
 hap auth login
 
 # Specific environment
@@ -66,7 +66,7 @@ hap auth login https://hap.example.com       # self-hosted
 hap auth login https://your-server.com --token YOUR_TOKEN
 ```
 
-The browser flow opens the MingDAO login page and captures the token. If the
+The browser flow opens the Mingdao login page and captures the token. If the
 callback can't reach the CLI (no GUI, restricted network), interrupt the
 command — it falls back to a paste prompt for the token shown on the success
 page.
@@ -78,7 +78,7 @@ hap auth logout        # log out the current account
 
 #### Multiple environments / accounts
 
-You can stay logged in to several environments (MingDAO SaaS, Nocoly, self-hosted) and
+You can stay logged in to several environments (Mingdao SaaS, Nocoly, self-hosted) and
 several accounts at once. Each is saved under a name and you switch between them:
 
 ```bash

{hap_cli-0.8.9/hap_cli → hap_cli-0.8.11}/README.md

@@ -1,6 +1,6 @@
 # hap-cli
 
-CLI harness for **MingDAO HAP** (明道云) — an enterprise no-code platform.
+CLI harness for **Mingdao HAP** (明道云) — an enterprise no-code platform.
 
 ## Installation
 
@@ -25,7 +25,7 @@ each organization's status (`CLI:on/off`).
 ### 1. Login
 
 ```bash
-# MingDAO SaaS (default)
+# Mingdao SaaS (default)
 hap auth login
 
 # Specific environment
@@ -37,7 +37,7 @@ hap auth login https://hap.example.com       # self-hosted
 hap auth login https://your-server.com --token YOUR_TOKEN
 ```
 
-The browser flow opens the MingDAO login page and captures the token. If the
+The browser flow opens the Mingdao login page and captures the token. If the
 callback can't reach the CLI (no GUI, restricted network), interrupt the
 command — it falls back to a paste prompt for the token shown on the success
 page.
@@ -49,7 +49,7 @@ hap auth logout        # log out the current account
 
 #### Multiple environments / accounts
 
-You can stay logged in to several environments (MingDAO SaaS, Nocoly, self-hosted) and
+You can stay logged in to several environments (Mingdao SaaS, Nocoly, self-hosted) and
 several accounts at once. Each is saved under a name and you switch between them:
 
 ```bash

{hap_cli-0.8.9 → hap_cli-0.8.11/hap_cli}/README.md

@@ -1,6 +1,6 @@
 # hap-cli
 
-CLI harness for **MingDAO HAP** (明道云) — an enterprise no-code platform.
+CLI harness for **Mingdao HAP** (明道云) — an enterprise no-code platform.
 
 ## Installation
 
@@ -25,7 +25,7 @@ each organization's status (`CLI:on/off`).
 ### 1. Login
 
 ```bash
-# MingDAO SaaS (default)
+# Mingdao SaaS (default)
 hap auth login
 
 # Specific environment
@@ -37,7 +37,7 @@ hap auth login https://hap.example.com       # self-hosted
 hap auth login https://your-server.com --token YOUR_TOKEN
 ```
 
-The browser flow opens the MingDAO login page and captures the token. If the
+The browser flow opens the Mingdao login page and captures the token. If the
 callback can't reach the CLI (no GUI, restricted network), interrupt the
 command — it falls back to a paste prompt for the token shown on the success
 page.
@@ -49,7 +49,7 @@ hap auth logout        # log out the current account
 
 #### Multiple environments / accounts
 
-You can stay logged in to several environments (MingDAO SaaS, Nocoly, self-hosted) and
+You can stay logged in to several environments (Mingdao SaaS, Nocoly, self-hosted) and
 several accounts at once. Each is saved under a name and you switch between them:
 
 ```bash

{hap_cli-0.8.9 → hap_cli-0.8.11}/hap_cli/README_CN.md

@@ -40,7 +40,7 @@ hap auth logout        # 登出当前账号
 
 #### 多环境 / 多账号
 
-可同时授权多个环境（MingDAO SaaS、Nocoly、私有部署）与多个账号，各存成一个具名档案，长期共存、随时切换：
+可同时授权多个环境（Mingdao SaaS、Nocoly、私有部署）与多个账号，各存成一个具名档案，长期共存、随时切换：
 
 ```bash
 hap auth login mingdao --profile work-prod        # 登录并起名保存

hap_cli-0.8.11/hap_cli/__init__.py

@@ -0,0 +1,3 @@
+"""CLI harness for Mingdao HAP (hap-cli)."""
+
+__version__ = "0.8.11"

hap_cli-0.8.11/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.9 → hap_cli-0.8.11}/hap_cli/commands/auth_cmd.py

@@ -378,7 +378,7 @@ def auth_whoami(ctx):
         # Read login_url from the active (or --profile) credential profile —
         # the in-memory Session may have been mutated, and we want whoami to
         # probe the server recorded for the profile in use. When the profile
-        # has no URL, fall back to the MingDAO SaaS host. Token failures
+        # has no URL, fall back to the Mingdao SaaS host. Token failures
         # (missing / expired) surface uniformly via AuthenticationError
         # → "Not logged in" hint from handle_error.
         profile_name = resolve_profile_name(ctx.profile)

{hap_cli-0.8.9 → hap_cli-0.8.11}/hap_cli/commands/chart_cmd.py

@@ -21,7 +21,7 @@ def chart():
     pass
 
 
-# Report-type enum values used by the MingDAO statistics module. The CLI
+# Report-type enum values used by the Mingdao statistics module. The CLI
 # 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).

{hap_cli-0.8.9 → hap_cli-0.8.11}/hap_cli/core/app.py

@@ -1,4 +1,4 @@
-"""Application management module for MingDAO HAP."""
+"""Application management module for Mingdao HAP."""
 
 from datetime import datetime, timedelta
 from typing import Any, Optional

hap_cli-0.8.11/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.
+"""