enow-cli 0.1.0__tar.gz

enow_cli-0.1.0/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: enow-cli
+Version: 0.1.0
+Summary: EmpowerNow extension deploy CLI — manifest-driven, cross-platform
+Requires-Python: >=3.11
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: click>=8.1
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-tmp-files>=0.0.2; extra == "dev"

enow_cli-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "enow-cli"
+version = "0.1.0"
+description = "EmpowerNow extension deploy CLI — manifest-driven, cross-platform"
+requires-python = ">=3.11"
+dependencies = [
+    "pyyaml>=6.0",
+    "click>=8.1",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "pytest-tmp-files>=0.0.2"]
+
+[project.scripts]
+enow = "enow_cli.main:cli"
+
+[tool.setuptools.packages.find]
+where = ["src"]

enow_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

enow_cli-0.1.0/src/enow_cli/__init__.py

@@ -0,0 +1,2 @@
+"""EmpowerNow extension deploy CLI."""
+__version__ = "0.1.0"

enow_cli-0.1.0/src/enow_cli/deploy.py

@@ -0,0 +1,250 @@
+"""
+Extension deploy engine.
+
+Copies extension artifacts into ServiceConfigs, handles PDP config
+merges, policy overlays, and experience plugin builds — all driven
+by extension.yaml.
+"""
+from __future__ import annotations
+
+import shutil
+import subprocess
+from dataclasses import dataclass, field
+from pathlib import Path
+
+from .manifest import ExtensionManifest, FileMapping, YamlMerge, PluginBuild, file_hash
+
+
+@dataclass
+class DeployAction:
+    """A single deploy action with its result."""
+    kind: str  # COPY, SKIP, MERGE, MKDIR, BUILD, HASH, ERROR
+    path: str
+    detail: str = ""
+
+
+@dataclass
+class DeployResult:
+    """Outcome of a deploy run."""
+    actions: list[DeployAction] = field(default_factory=list)
+    copied: int = 0
+    unchanged: int = 0
+    merged: int = 0
+    errors: int = 0
+
+    @property
+    def success(self) -> bool:
+        return self.errors == 0
+
+
+def deploy_extension(
+    manifest: ExtensionManifest,
+    serviceconfigs_root: Path,
+    dry_run: bool = False,
+) -> DeployResult:
+    """
+    Deploy an extension package into ServiceConfigs.
+
+    Steps:
+    1. Sync extension files into extensions/<id>/
+    2. Copy PDP policy files into pdp/config/policies/
+    3. Merge YAML fragments into shared PDP configs
+    4. Build experience plugins and copy bundles + update integrity
+    """
+    result = DeployResult()
+    ext_target = serviceconfigs_root / "extensions" / manifest.id
+    pdp_config = serviceconfigs_root / "pdp" / "config"
+
+    _sync_files(manifest.get_file_mappings(), ext_target, dry_run, result)
+    _copy_policies(manifest.get_policy_copies(), pdp_config, dry_run, result)
+    _merge_yamls(manifest.get_yaml_merges(), pdp_config, dry_run, result)
+    _build_plugins(manifest.get_plugin_builds(), serviceconfigs_root, dry_run, result)
+
+    return result
+
+
+def diff_extension(
+    manifest: ExtensionManifest,
+    serviceconfigs_root: Path,
+) -> list[DeployAction]:
+    """Show what would change without modifying anything."""
+    actions: list[DeployAction] = []
+    ext_target = serviceconfigs_root / "extensions" / manifest.id
+
+    for fm in manifest.get_file_mappings():
+        dst = ext_target / fm.dst_relative
+        if not fm.exists:
+            actions.append(DeployAction("MISSING", fm.dst_relative, f"Source: {fm.src}"))
+            continue
+        if not dst.is_file():
+            actions.append(DeployAction("NEW", fm.dst_relative))
+        elif file_hash(fm.src) != file_hash(dst):
+            actions.append(DeployAction("CHANGED", fm.dst_relative))
+
+    pdp_config = serviceconfigs_root / "pdp" / "config"
+    for merge in manifest.get_yaml_merges():
+        target = pdp_config / merge.target_relative
+        if not target.is_file():
+            actions.append(DeployAction("NEW", f"pdp/config/{merge.target_relative}"))
+        else:
+            content = target.read_text(encoding="utf-8")
+            if merge.marker not in content:
+                actions.append(DeployAction("MERGE", f"pdp/config/{merge.target_relative}", f"marker: {merge.marker}"))
+
+    return actions
+
+
+def _sync_files(
+    mappings: list[FileMapping],
+    target_root: Path,
+    dry_run: bool,
+    result: DeployResult,
+) -> None:
+    for fm in mappings:
+        dst = target_root / fm.dst_relative
+        if not fm.exists:
+            result.actions.append(DeployAction("MISSING", fm.dst_relative, f"{fm.src}"))
+            result.errors += 1
+            continue
+
+        if dst.is_file() and file_hash(fm.src) == file_hash(dst):
+            result.actions.append(DeployAction("SKIP", fm.dst_relative))
+            result.unchanged += 1
+            continue
+
+        if not dry_run:
+            dst.parent.mkdir(parents=True, exist_ok=True)
+            shutil.copy2(fm.src, dst)
+
+        result.actions.append(DeployAction("COPY", fm.dst_relative))
+        result.copied += 1
+
+
+def _copy_policies(
+    policies: list[FileMapping],
+    pdp_config_root: Path,
+    dry_run: bool,
+    result: DeployResult,
+) -> None:
+    for fm in policies:
+        dst = pdp_config_root / fm.dst_relative
+        if not fm.exists:
+            result.actions.append(DeployAction("MISSING", fm.dst_relative, f"{fm.src}"))
+            result.errors += 1
+            continue
+
+        if dst.is_file() and file_hash(fm.src) == file_hash(dst):
+            result.actions.append(DeployAction("SKIP", f"pdp/{fm.dst_relative}"))
+            result.unchanged += 1
+            continue
+
+        if not dry_run:
+            dst.parent.mkdir(parents=True, exist_ok=True)
+            shutil.copy2(fm.src, dst)
+
+        result.actions.append(DeployAction("COPY", f"pdp/{fm.dst_relative}"))
+        result.copied += 1
+
+
+def _merge_yamls(
+    merges: list[YamlMerge],
+    pdp_config_root: Path,
+    dry_run: bool,
+    result: DeployResult,
+) -> None:
+    for merge in merges:
+        if not merge.src.is_file():
+            result.actions.append(DeployAction("MISSING", merge.target_relative, f"{merge.src}"))
+            result.errors += 1
+            continue
+
+        target = pdp_config_root / merge.target_relative
+        if not target.is_file():
+            if not dry_run:
+                target.parent.mkdir(parents=True, exist_ok=True)
+                shutil.copy2(merge.src, target)
+            result.actions.append(DeployAction("COPY", f"pdp/config/{merge.target_relative}", "new file"))
+            result.copied += 1
+            continue
+
+        content = target.read_text(encoding="utf-8")
+        if merge.marker and merge.marker in content:
+            result.actions.append(DeployAction("SKIP", f"pdp/config/{merge.target_relative}", f"marker '{merge.marker}' present"))
+            result.unchanged += 1
+            continue
+
+        if not dry_run:
+            fragment = merge.src.read_text(encoding="utf-8")
+            separator = "\n" if content.endswith("\n") else "\n\n"
+            with open(target, "a", encoding="utf-8") as f:
+                f.write(separator + fragment)
+
+        result.actions.append(DeployAction("MERGE", f"pdp/config/{merge.target_relative}", f"appended '{merge.marker}'"))
+        result.merged += 1
+
+
+def _build_plugins(
+    plugins: list[PluginBuild],
+    serviceconfigs_root: Path,
+    dry_run: bool,
+    result: DeployResult,
+) -> None:
+    for plugin in plugins:
+        pkg_json = plugin.source_dir / "package.json"
+        if not pkg_json.is_file():
+            result.actions.append(DeployAction("SKIP", f"plugin:{plugin.plugin_id}", "no package.json"))
+            return
+
+        if dry_run:
+            result.actions.append(DeployAction("BUILD", f"plugin:{plugin.plugin_id}", "would build"))
+            result.actions.append(DeployAction("COPY", f"BFF/plugins/{plugin.plugin_id}/{plugin.version}/index.esm.js"))
+            result.actions.append(DeployAction("HASH", f"BFF/config/plugins/manifests/{plugin.plugin_id}.yaml"))
+            return
+
+        node_modules = plugin.source_dir / "node_modules"
+        if not node_modules.is_dir():
+            proc = subprocess.run(
+                ["npm", "install", "--silent"],
+                cwd=plugin.source_dir,
+                capture_output=True, text=True,
+            )
+            if proc.returncode != 0:
+                result.actions.append(DeployAction("ERROR", f"plugin:{plugin.plugin_id}", f"npm install failed: {proc.stderr[:200]}"))
+                result.errors += 1
+                continue
+
+        proc = subprocess.run(
+            plugin.build_command.split(),
+            cwd=plugin.source_dir,
+            capture_output=True, text=True,
+        )
+        if proc.returncode != 0:
+            result.actions.append(DeployAction("ERROR", f"plugin:{plugin.plugin_id}", f"build failed: {proc.stderr[:200]}"))
+            result.errors += 1
+            continue
+
+        result.actions.append(DeployAction("BUILD", f"plugin:{plugin.plugin_id}", "success"))
+
+        bundle_src = plugin.bundle_path
+        if not bundle_src.is_file():
+            result.actions.append(DeployAction("ERROR", f"plugin:{plugin.plugin_id}", f"bundle not found: {bundle_src}"))
+            result.errors += 1
+            continue
+
+        bundle_dst = serviceconfigs_root / "BFF" / "plugins" / plugin.plugin_id / plugin.version / "index.esm.js"
+        bundle_dst.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copy2(bundle_src, bundle_dst)
+        result.actions.append(DeployAction("COPY", str(bundle_dst.relative_to(serviceconfigs_root))))
+        result.copied += 1
+
+        integrity = f"sha256:{file_hash(bundle_dst)}"
+        manifest_path = serviceconfigs_root / "BFF" / "config" / "plugins" / "manifests" / f"{plugin.plugin_id}.yaml"
+        if manifest_path.is_file():
+            content = manifest_path.read_text(encoding="utf-8")
+            import re
+            updated = re.sub(r"integrity:\s*sha256:[a-f0-9]+", f"integrity: {integrity}", content)
+            if updated != content:
+                manifest_path.write_text(updated, encoding="utf-8")
+                result.actions.append(DeployAction("HASH", str(manifest_path.relative_to(serviceconfigs_root)), integrity))
+        else:
+            result.actions.append(DeployAction("WARN", f"manifests/{plugin.plugin_id}.yaml", "not found — update integrity manually"))

enow_cli-0.1.0/src/enow_cli/main.py

@@ -0,0 +1,215 @@
+"""
+enow CLI — EmpowerNow extension management tool.
+
+Usage:
+    enow extension validate [PATH]
+    enow extension deploy --target <serviceconfigs> [--dry-run]
+    enow extension diff --target <serviceconfigs>
+"""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+import click
+
+from .manifest import ExtensionManifest, ManifestError
+from .deploy import deploy_extension, diff_extension
+from .scaffold import scaffold_extension, ALL_SURFACES, DEFAULT_SURFACES
+
+
+def _find_manifest(path: str | None) -> Path:
+    """Resolve extension.yaml from a path or current directory."""
+    if path:
+        p = Path(path)
+        if p.is_file() and p.name == "extension.yaml":
+            return p
+        if p.is_dir():
+            candidate = p / "extension.yaml"
+            if candidate.is_file():
+                return candidate
+            raise click.ClickException(f"No extension.yaml found in {p}")
+        raise click.ClickException(f"Path not found: {p}")
+
+    cwd = Path.cwd()
+    candidate = cwd / "extension.yaml"
+    if candidate.is_file():
+        return candidate
+
+    for parent in cwd.parents:
+        candidate = parent / "extension.yaml"
+        if candidate.is_file():
+            return candidate
+        if (parent / ".git").exists():
+            break
+
+    raise click.ClickException(
+        "No extension.yaml found. Run from an extension repo or pass --path."
+    )
+
+
+@click.group()
+@click.version_option()
+def cli():
+    """EmpowerNow extension management CLI."""
+    pass
+
+
+@cli.group()
+def extension():
+    """Manage extension packages."""
+    pass
+
+
+@extension.command()
+@click.argument("path", required=False)
+def validate(path: str | None):
+    """Validate an extension.yaml manifest and check all referenced files exist."""
+    manifest_path = _find_manifest(path)
+    click.echo(f"Validating: {manifest_path}")
+
+    try:
+        manifest = ExtensionManifest.load(manifest_path)
+    except ManifestError as e:
+        click.secho(f"FAIL  Manifest error: {e}", fg="red")
+        sys.exit(1)
+
+    click.echo(f"  id:        {manifest.id}")
+    click.echo(f"  version:   {manifest.version}")
+    click.echo(f"  status:    {manifest.status}")
+    click.echo(f"  enabled:   {manifest.enabled}")
+    click.echo(f"  namespace: {manifest.namespace}")
+    click.echo()
+
+    errors = manifest.validate_files()
+    mappings = manifest.get_file_mappings()
+    merges = manifest.get_yaml_merges()
+    plugins = manifest.get_plugin_builds()
+    policies = manifest.get_policy_copies()
+
+    click.echo(f"Files:    {len(mappings)} mapped")
+    click.echo(f"Merges:   {len(merges)} YAML merge(s)")
+    click.echo(f"Policies: {len(policies)} policy file(s)")
+    click.echo(f"Plugins:  {len(plugins)} experience plugin(s)")
+    click.echo()
+
+    if errors:
+        click.secho(f"FAIL  {len(errors)} error(s):", fg="red")
+        for err in errors:
+            click.secho(f"  {err}", fg="red")
+        sys.exit(1)
+    else:
+        click.secho("OK  All referenced files exist.", fg="green")
+
+
+@extension.command()
+@click.option("--target", "-t", required=True, type=click.Path(exists=True),
+              help="Path to ServiceConfigs repo root")
+@click.option("--dry-run", is_flag=True, help="Show what would change without modifying files")
+@click.option("--path", "-p", default=None, help="Path to extension repo or extension.yaml")
+def deploy(target: str, dry_run: bool, path: str | None):
+    """Deploy extension package into ServiceConfigs."""
+    manifest_path = _find_manifest(path)
+    manifest = ExtensionManifest.load(manifest_path)
+
+    click.echo(f"Deploying: {manifest.id} v{manifest.version}")
+    click.echo(f"  Source: {manifest.root}")
+    click.echo(f"  Target: {target}")
+    if dry_run:
+        click.secho("  [DRY RUN]", fg="yellow")
+    click.echo()
+
+    result = deploy_extension(manifest, Path(target), dry_run=dry_run)
+
+    for action in result.actions:
+        color = {
+            "COPY": "green", "MERGE": "green", "BUILD": "cyan",
+            "HASH": "cyan", "SKIP": None, "MISSING": "red",
+            "ERROR": "red", "WARN": "yellow", "MKDIR": None,
+        }.get(action.kind, None)
+        detail = f" ({action.detail})" if action.detail else ""
+        click.secho(f"  {action.kind:<7} {action.path}{detail}", fg=color)
+
+    click.echo()
+    click.echo(
+        f"Done: {result.copied} copied, {result.merged} merged, "
+        f"{result.unchanged} unchanged, {result.errors} errors"
+    )
+
+    if not result.success:
+        sys.exit(1)
+
+
+@extension.command()
+@click.option("--target", "-t", required=True, type=click.Path(exists=True),
+              help="Path to ServiceConfigs repo root")
+@click.option("--path", "-p", default=None, help="Path to extension repo or extension.yaml")
+def diff(target: str, path: str | None):
+    """Show what would change in ServiceConfigs (no modifications)."""
+    manifest_path = _find_manifest(path)
+    manifest = ExtensionManifest.load(manifest_path)
+
+    click.echo(f"Diff: {manifest.id} v{manifest.version} -> {target}")
+    click.echo()
+
+    actions = diff_extension(manifest, Path(target))
+
+    if not actions:
+        click.secho("No changes needed — target is up to date.", fg="green")
+        return
+
+    for action in actions:
+        color = {"NEW": "green", "CHANGED": "yellow", "MERGE": "cyan", "MISSING": "red"}.get(action.kind, None)
+        detail = f" ({action.detail})" if action.detail else ""
+        click.secho(f"  {action.kind:<8} {action.path}{detail}", fg=color)
+
+    click.echo()
+    click.echo(f"{len(actions)} change(s) pending.")
+
+
+@extension.command()
+@click.option("--name", "-n", required=True, help="Extension id (e.g. acme-corp)")
+@click.option("--namespace", "-ns", required=True, help="Short namespace prefix (e.g. acme)")
+@click.option(
+    "--surface", "-s", multiple=True,
+    type=click.Choice(ALL_SURFACES, case_sensitive=False),
+    help="Surfaces to include (repeatable). Defaults: config_pack, policy_pack, membership_projection, seed_data",
+)
+@click.option("--customer", "-c", default="", help="Customer name for the owner block")
+@click.option("--team", default="platform-engineering", help="Team name for the owner block")
+@click.option("--output", "-o", default=".", type=click.Path(), help="Output parent directory")
+def scaffold(name: str, namespace: str, surface: tuple[str, ...], customer: str, team: str, output: str):
+    """Generate a new extension package from a template."""
+    surfaces = list(surface) if surface else None
+    output_path = Path(output)
+
+    click.echo(f"Scaffolding extension: {name}")
+    click.echo(f"  Namespace: {namespace}")
+    click.echo(f"  Surfaces:  {', '.join(surfaces or DEFAULT_SURFACES)}")
+    click.echo(f"  Output:    {output_path / name}")
+    click.echo()
+
+    result = scaffold_extension(
+        output_dir=output_path,
+        name=name,
+        namespace=namespace,
+        surfaces=surfaces,
+        customer=customer,
+        team=team,
+    )
+
+    click.secho(f"Created {len(result.files_created)} files:", fg="green")
+    for f in result.files_created:
+        rel = Path(f).relative_to(result.root) if Path(f).is_relative_to(result.root) else f
+        click.echo(f"  {rel}")
+
+    click.echo()
+    click.secho("Next steps:", fg="cyan")
+    click.echo(f"  1. cd {result.root}")
+    click.echo(f"  2. Edit extension.yaml and fill in capabilities")
+    click.echo(f"  3. enow extension validate")
+    click.echo(f"  4. enow extension deploy --target /path/to/ServiceConfigs")
+
+
+if __name__ == "__main__":
+    cli()