alex-de-haas/docker-host

hosty-app-skill

Build, wrap, or update Hosty runtime apps.

Zobacz źródło

Jak używać

  1. Skopiuj polecenie instalacji i sprawdź źródła przed instalacją we własnym środowisku agenta.
  2. W oryginale sprawdź wymagane narzędzia, dane dostępowe i obsługiwane środowiska.
  3. Opisz dane wejściowe i oczekiwany rezultat; porównaj wynik ze źródłami.
npx skills add https://github.com/alex-de-haas/docker-host --skill hosty-app-skill

Przed rozpoczęciem

  • Instalacja nie obejmuje subskrypcji modelu, limitu API ani uprawnień do plików.
  • Gwiazdki i instalacje pokazują aktywność, a nie niezależny test jakości lub bezpieczeństwa.
Oryginalny dokument Skill

Treść z repozytorium z zachowaniem nagłówków, przykładów, kodu, tabel, linków i obrazów.

Hosty App Skill

Use this skill to implement Hosty runtime apps in the shape expected by this repository. The supported contract is an app manifest with schemaVersion: "app.0.1".

Workflow

  1. Identify whether the user wants to create a new runtime app, wrap an existing app, update an app manifest, add Hosty identity/roles, configure data/backups, or validate an app.
  2. Treat docs/features/runtime-app-manifest/feature.md, docs/features/domain-model/feature.md, docs/features/auth-gateway/feature.md, apps/core/src/Haas.Hosty.Core/RuntimeAppManifest.cs, apps/core/src/Haas.Hosty.Core/CoreLifecycleService.cs, and apps/demo-app as source of truth when implementation details matter.
  3. Use apps/demo-app/manifest.json as the manifest shape and hosty apps install apps/demo-app --runtime dev as the local directory install pattern.

References

  • Read references/app-manifest.md when authoring or reviewing manifest.json, runtime profiles, service implementations, settings, storage, dependencies, endpoints, install/update behavior, or backups.
  • Read references/app-auth-and-users.md when adding app identity, app-owned roles, or scoped app directory access.
  • Read references/app-manifest.md ("MCP Interface") when adding or debugging an app's MCP endpoint — delegated- and scoped-token auth, the handshake's HTTP 202, and read-only annotations.
  • Read references/app-feeds.md when publishing or reviewing repository-owned feeds.json for Marketplace discovery and Core-managed updates.
  • Read references/app-launch-mode.md when the app has a UI, to keep it from drawing the name and page navigation a shell already renders around it.
  • Read references/demo-app-patterns.md when validating against the repository Demo App.
  • Read references/app-implementation-checklist.md before final verification.

Local Validation

Use Core-managed runtime app lifecycle:

bash
hosty core start
hosty apps install apps/demo-app --runtime dev
hosty apps start com.haas.demo-app

For direct endpoint probes:

bash
TOKEN="$(hosty apps identity com.haas.demo-app --user user@docker-host.local --format token)"
curl -H "X-Docker-Host-Identity: $TOKEN" <assigned-demo-app-origin>/api/auth/identity

Powiązane zadania