aihr 0.2.0__py3-none-any.whl

aihr-0.2.0.data/data/share/aihr/configs/deployable.yaml

@@ -0,0 +1,26 @@
+# deployable.yaml — the ONLY hand-maintained model list in this repo.
+#
+# Every model the opencode config declares (opencode.jsonc provider.*;
+# models) is derived automatically — add/retire it there and it flows into
+# stage sweep pools / discover / routing / the deployable set with ZERO
+# edits here (hr/fleet.py resolves the fleet at runtime).
+#
+# `extra_deployable:` lists models served OUTSIDE the opencode config —
+# registry-only providers (kimi-for-coding, deepseek) opencode loads from
+# its own registry. This is user policy, not a mirror.
+#
+# Drift guard: an entry that duplicates a config-declared model is REJECTED
+# at runtime (hr.fleet.merge_with_extras) — the model must be removed from
+# this list, not duplicated. Add the provider's wire here and in the
+# `wire_overrides:` map of configs/fleet.yaml.
+# EXAMPLES ONLY — this tracked file ships with an EMPTY list. A live
+# machine's extra models live in the gitignored configs/deployable.local.yaml
+# overlay (deep-merged by hr.config.load_yaml; the overlay LIST REPLACES
+# this one, it is not appended). First-install: `cp configs/deployable.yaml
+# configs/deployable.local.yaml`, then fill the list with your registry-only
+# models (provider/slug) and declare each provider's wire in the
+# configs/fleet.local.yaml wire_overrides map. An extra duplicating a
+# config-declared model is still REJECTED at runtime (drift guard).
+extra_deployable: []
+# example:
+#   - example-provider/example-model-a

aihr-0.2.0.data/data/share/aihr/configs/fleet.yaml

@@ -0,0 +1,56 @@
+# fleet.yaml — OPTIONAL overrides for the dynamically derived model fleet.
+#
+# The fleet is NOT snapshotted here anymore (hr-unification todo 23's static
+# manifest was rejected: fixed model names drift from opencode's live config).
+# At RUNTIME hr derives the full inventory from the opencode config files
+# themselves — every `provider.*.models` entry in opencode.jsonc (global +
+# project, project merged over global) becomes a fleet model, its wire type
+# derives from the provider's `npm` field via an explicit table, and new
+# models flow into the stage sweep pools / `hr discover` / adapter routing
+# with ZERO edits in this repo.
+#
+# This file exists only for the policy knobs a derivation cannot answer:
+#
+#   wire_overrides:  wire type for providers whose npm field is absent or
+#                    unknown. Registry-only providers (kimi-for-coding,
+#                    deepseek) are NOT declared in opencode.jsonc — their
+#                    models live under configs/deployable.yaml
+#                    `extra_deployable:`, and their wire MUST be declared
+#                    here. The config-declared `azure` gateway carries no
+#                    npm field either, so its wire is declared here too. A
+#                    config-declared provider with a known npm needs nothing.
+#                    Unknown npm + no override = fail loud at runtime (never
+#                    a silent guess).
+#
+#   scope_excludes:  providers kept OUT of the default discover/sweep scope.
+#                    Everything the opencode config declares is in scope by
+#                    default (new providers auto-inherit); an explicit
+#                    exclusion here is the ONLY way to opt a provider out.
+#
+#   gateway_urls:    per-provider gateway base URL used when a provider has
+#                    NO options.baseURL in the opencode config (registry-only
+#                    providers such as kimi-for-coding / deepseek, served via
+#                    their own gateways) — the auth.json fallback in
+#                    hr.config.get_provider_config and the anthropic adapter
+#                    resolve through it. Endpoint URLs are routing data, not
+#                    credentials. A provider with no config block, no gateway
+#                    entry and no auth entry is a fail-loud config error.
+
+# EXAMPLES ONLY — this tracked file ships with zero real deployment values.
+# A live machine declares its real overrides in the gitignored
+# configs/fleet.local.yaml overlay (deep-merged by hr.config.load_yaml:
+# dicts merge per key, LIST VALUES ARE REPLACED, not merged). Keep the real
+# wire_overrides / scope_excludes / gateway_urls entries there; wire
+# overrides must cover every registry-only provider served via the
+# deployable extra_deployable list, and gateway_urls covers providers with
+# no options.baseURL in the opencode config. Unknown npm + no override =
+# fail loud at runtime (never a silent guess).
+
+wire_overrides:
+  example-provider: anthropic-compat
+
+scope_excludes:
+  - example-excluded-provider
+
+gateway_urls:
+  example-provider: https://gateway.example.invalid/v1

aihr-0.2.0.data/data/share/aihr/configs/hr.toml.example

@@ -0,0 +1,26 @@
+# HR v1 configuration template.
+# Copy to hr.toml and adjust for your environment.
+#
+# Secrets (db_password, API keys) are NEVER stored here.
+# Set them via environment variables instead:
+#   HR_DSN            — full PostgreSQL connection string (preferred); overrides individual db_* fields
+#   HR_DB_PASSWORD    — password for the wiki DB (required if HR_DSN is not set)
+#   HR_DB_USER        — DB username (default: "wikijs")
+#   HR_BAILIAN_API_KEY — Bailian provider API key
+#   WIKI_API_KEY_FILE — path to Wiki.js JWT token file (default: ~/.wikijs-api-key)
+
+# --- Database connection (non-secret fields) ---
+db_host = "localhost"
+db_port = 5432
+db_name = "wiki"
+db_user = "wikijs"
+
+# Example HR_DSN (uncomment and fill in real values):
+# dsn = "postgresql://username:PASSWORD@localhost:5432/wiki"
+
+# --- Optional Wiki.js publish target for `hr publish` ---
+# Without this [wiki] section the command prints "wiki not configured,
+# skipping" and exits 0 — the wiki is an optional publish target.
+# [wiki]
+# graphql_url = "http://localhost:3000/graphql"
+# api_key_file = "~/.wikijs-api-key"