@holdyourvoice/hyv 3.3.5 → 3.4.0

package/skills/hyv-apply-rebuild/agent.json

@@ -0,0 +1,49 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-apply-rebuild",
+  "title": "hyv-apply-rebuild",
+  "description": "Validate and evaluate a whole-document rebuild response against a prepared authorized rebuild task.",
+  "instruction_file": "SKILL.md",
+  "role": "Rebuild applier",
+  "workflow_phase": "edit",
+  "input": {
+    "required": [
+      "task.json",
+      "response.json",
+      "profile.json",
+      "capability stdin or file"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "applied rebuild candidate and gate report"
+    ],
+    "optional": []
+  },
+  "evidence_requirements": [
+    "Report only the deterministic result the command returns; never invent a model or provider call that did not occur."
+  ],
+  "permissions": [
+    "execute_commands",
+    "read_repository"
+  ],
+  "stop_conditions": [
+    "Stop when required input is missing, when the command cannot run without changing existing behavior, or when a claimed capability is unavailable."
+  ],
+  "tool_free_mode": {
+    "available": true,
+    "behavior": "Provide the decision, artifact template, and exact unavailable capability; never claim a tool action occurred.",
+    "unavailable_statuses": [
+      "NOT_AVAILABLE",
+      "NOT_CONFIGURED",
+      "NOT_RUN",
+      "STALE",
+      "ERROR"
+    ]
+  },
+  "handoff_to": [
+    "hyv-verify",
+    "hyv-lifecycle"
+  ]
+}

package/skills/hyv-apply-rebuild/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Apply Rebuild"
+  short_description: "Validate and evaluate a whole-document rebuild response against a prepared authorized rebuild task."
+  default_prompt: "Use $hyv-apply-rebuild to validate and evaluate a whole-document rebuild response against a prepared authorized rebuild task."

package/skills/hyv-apply-rewrite/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-apply-rewrite
+description: Validate and apply a model response to a prepared rewrite task, then run local gates.
+---
+
+# hyv-apply-rewrite
+
+Validate and apply a model response to a prepared task, then run the local gates. It never calls a provider or stores source or candidate text. Exits 2 unless the result is accepted.
+
+## Usage
+
+```text
+hyv apply-rewrite task.json response.json profile.json
+```
+
+## Behavior
+
+- Deterministic and local-first: this command never calls a provider and never sends drafts, samples, profiles, or telemetry to a service.
+- Commands that write use an explicit output path. Confirm that path before running the command.
+- This agent describes how to invoke the command and what it returns. It does not change command behavior or exit codes.
+
+## Handoff
+
+Run `hyv apply-rewrite` directly to execute the operation. Follow-on agents: hyv-verify, hyv-prepare-judgment.

package/skills/hyv-apply-rewrite/agent.json

@@ -0,0 +1,48 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-apply-rewrite",
+  "title": "hyv-apply-rewrite",
+  "description": "Validate and apply a model response to a prepared rewrite task, then run local gates.",
+  "instruction_file": "SKILL.md",
+  "role": "Edit applier",
+  "workflow_phase": "edit",
+  "input": {
+    "required": [
+      "task.json",
+      "response.json",
+      "profile.json"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "applied candidate and gate report"
+    ],
+    "optional": []
+  },
+  "evidence_requirements": [
+    "Report only the deterministic result the command returns; never invent a model or provider call that did not occur."
+  ],
+  "permissions": [
+    "execute_commands",
+    "read_repository"
+  ],
+  "stop_conditions": [
+    "Stop when required input is missing, when the command cannot run without changing existing behavior, or when a claimed capability is unavailable."
+  ],
+  "tool_free_mode": {
+    "available": true,
+    "behavior": "Provide the decision, artifact template, and exact unavailable capability; never claim a tool action occurred.",
+    "unavailable_statuses": [
+      "NOT_AVAILABLE",
+      "NOT_CONFIGURED",
+      "NOT_RUN",
+      "STALE",
+      "ERROR"
+    ]
+  },
+  "handoff_to": [
+    "hyv-verify",
+    "hyv-prepare-judgment"
+  ]
+}

package/skills/hyv-apply-rewrite/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Apply Rewrite"
+  short_description: "Validate and apply a model response to a prepared rewrite task, then run local gates."
+  default_prompt: "Use $hyv-apply-rewrite to validate and apply a model response to a prepared rewrite task, then run local gates."

package/skills/hyv-batch-analyze/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-batch-analyze
+description: Inspect two to one hundred drafts for repeated opening and closing sentences.
+---
+
+# hyv-batch-analyze
+
+Inspect two to one hundred drafts for repeated opening and closing sentences. It returns advisory batch findings and does not store the drafts.
+
+## Usage
+
+```text
+hyv batch-analyze draft-a.md draft-b.md [draft-c.md]
+```
+
+## Behavior
+
+- Deterministic and local-first: this command never calls a provider and never sends drafts, samples, profiles, or telemetry to a service.
+- Commands that write use an explicit output path. Confirm that path before running the command.
+- This agent describes how to invoke the command and what it returns. It does not change command behavior or exit codes.
+
+## Handoff
+
+Run `hyv batch-analyze` directly to execute the operation. Follow-on agents: hyv-analyze.

package/skills/hyv-batch-analyze/agent.json

@@ -0,0 +1,45 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-batch-analyze",
+  "title": "hyv-batch-analyze",
+  "description": "Inspect two to one hundred drafts for repeated opening and closing sentences.",
+  "instruction_file": "SKILL.md",
+  "role": "Batch analyzer",
+  "workflow_phase": "analyze",
+  "input": {
+    "required": [
+      "two or more draft paths"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "advisory batch findings"
+    ],
+    "optional": []
+  },
+  "evidence_requirements": [
+    "Report only the deterministic result the command returns; never invent a model or provider call that did not occur."
+  ],
+  "permissions": [
+    "execute_commands",
+    "read_repository"
+  ],
+  "stop_conditions": [
+    "Stop when required input is missing, when the command cannot run without changing existing behavior, or when a claimed capability is unavailable."
+  ],
+  "tool_free_mode": {
+    "available": true,
+    "behavior": "Provide the decision, artifact template, and exact unavailable capability; never claim a tool action occurred.",
+    "unavailable_statuses": [
+      "NOT_AVAILABLE",
+      "NOT_CONFIGURED",
+      "NOT_RUN",
+      "STALE",
+      "ERROR"
+    ]
+  },
+  "handoff_to": [
+    "hyv-analyze"
+  ]
+}

package/skills/hyv-batch-analyze/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Batch Analyze"
+  short_description: "Inspect two to one hundred drafts for repeated opening and closing sentences."
+  default_prompt: "Use $hyv-batch-analyze to inspect two to one hundred drafts for repeated opening and closing sentences."

package/skills/hyv-fact-lint/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-fact-lint
+description: Lint factual claims in a draft against named sources.
+---
+
+# hyv-fact-lint
+
+Lint factual claims in a draft against one or more named sources passed as --source=id:path. Optional --metadata provides fact metadata, --strict raises severity, and --human selects the human-readable report.
+
+## Usage
+
+```text
+hyv fact-lint <draft|-> --source=id:path [--source=id:path] [--metadata=metadata.json] [--strict] [--human]
+```
+
+## Behavior
+
+- Deterministic and local-first: this command never calls a provider and never sends drafts, samples, profiles, or telemetry to a service.
+- Commands that write use an explicit output path. Confirm that path before running the command.
+- This agent describes how to invoke the command and what it returns. It does not change command behavior or exit codes.
+
+## Handoff
+
+Run `hyv fact-lint` directly to execute the operation. Follow-on agents: hyv-verify.

package/skills/hyv-fact-lint/agent.json

@@ -0,0 +1,50 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-fact-lint",
+  "title": "hyv-fact-lint",
+  "description": "Lint factual claims in a draft against named sources.",
+  "instruction_file": "SKILL.md",
+  "role": "Fact linter",
+  "workflow_phase": "verify",
+  "input": {
+    "required": [
+      "draft path",
+      "one or more --source=id:path"
+    ],
+    "optional": [
+      "--metadata=metadata.json",
+      "--strict",
+      "--human"
+    ]
+  },
+  "output": {
+    "required": [
+      "fact lint report"
+    ],
+    "optional": []
+  },
+  "evidence_requirements": [
+    "Report only the deterministic result the command returns; never invent a model or provider call that did not occur."
+  ],
+  "permissions": [
+    "execute_commands",
+    "read_repository"
+  ],
+  "stop_conditions": [
+    "Stop when required input is missing, when the command cannot run without changing existing behavior, or when a claimed capability is unavailable."
+  ],
+  "tool_free_mode": {
+    "available": true,
+    "behavior": "Provide the decision, artifact template, and exact unavailable capability; never claim a tool action occurred.",
+    "unavailable_statuses": [
+      "NOT_AVAILABLE",
+      "NOT_CONFIGURED",
+      "NOT_RUN",
+      "STALE",
+      "ERROR"
+    ]
+  },
+  "handoff_to": [
+    "hyv-verify"
+  ]
+}

package/skills/hyv-fact-lint/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Fact Lint"
+  short_description: "Lint factual claims in a draft against named sources."
+  default_prompt: "Use $hyv-fact-lint to lint factual claims in a draft against named sources."

package/skills/hyv-final-check/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-final-check
+description: Gate exact user-facing text from any model, tool, or interface.
+---
+
+# hyv-final-check
+
+Gate exact final text from every producer. Returns output only when clean or after removing a leading byte-order mark; unresolved hidden characters withhold output. It does not require or select a VoiceDNA profile. Run it immediately before display, copy, export, posting, or returning an API response.
+
+## Usage
+
+```text
+hyv final-check <path|->
+```
+
+## Behavior
+
+- Deterministic and local-first: this command never calls a provider and never sends drafts, samples, profiles, or telemetry to a service.
+- Commands that write use an explicit output path. Confirm that path before running the command.
+- This agent describes how to invoke the command and what it returns. It does not change command behavior or exit codes.
+
+## Handoff
+
+Run `hyv final-check` directly to execute the operation.

package/skills/hyv-final-check/agent.json

@@ -0,0 +1,43 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-final-check",
+  "title": "hyv-final-check",
+  "description": "Gate exact user-facing text from any model, tool, or interface.",
+  "instruction_file": "SKILL.md",
+  "role": "Output gate",
+  "workflow_phase": "verify",
+  "input": {
+    "required": [
+      "text path or -"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "accepted output or withheld report"
+    ],
+    "optional": []
+  },
+  "evidence_requirements": [
+    "Report only the deterministic result the command returns; never invent a model or provider call that did not occur."
+  ],
+  "permissions": [
+    "execute_commands",
+    "read_repository"
+  ],
+  "stop_conditions": [
+    "Stop when required input is missing, when the command cannot run without changing existing behavior, or when a claimed capability is unavailable."
+  ],
+  "tool_free_mode": {
+    "available": true,
+    "behavior": "Provide the decision, artifact template, and exact unavailable capability; never claim a tool action occurred.",
+    "unavailable_statuses": [
+      "NOT_AVAILABLE",
+      "NOT_CONFIGURED",
+      "NOT_RUN",
+      "STALE",
+      "ERROR"
+    ]
+  },
+  "handoff_to": []
+}

package/skills/hyv-final-check/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Final Check"
+  short_description: "Gate exact user-facing text from any model, tool, or interface."
+  default_prompt: "Use $hyv-final-check to gate exact user-facing text from any model, tool, or interface."

package/skills/hyv-hygiene/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-hygiene
+description: Inspect text for zero-width characters, bidirectional controls, tag characters, and unusual spaces.
+---
+
+# hyv-hygiene
+
+Inspect text for zero-width characters, bidirectional controls, Unicode tag characters, and unusual spaces without requiring a voice profile. Inspection is read-only. --fix writes a new cleaned path (never overwriting the input or an existing output), reports every changed offset, and preserves controls it is not authorized to remove.
+
+## Usage
+
+```text
+hyv hygiene draft.md [--fix] [--output=cleaned.md]
+```
+
+## Behavior
+
+- Deterministic and local-first: this command never calls a provider and never sends drafts, samples, profiles, or telemetry to a service.
+- Commands that write use an explicit output path. Confirm that path before running the command.
+- This agent describes how to invoke the command and what it returns. It does not change command behavior or exit codes.
+
+## Handoff
+
+Run `hyv hygiene` directly to execute the operation. Follow-on agents: hyv-final-check.

package/skills/hyv-hygiene/agent.json

@@ -0,0 +1,50 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-hygiene",
+  "title": "hyv-hygiene",
+  "description": "Inspect text for zero-width characters, bidirectional controls, tag characters, and unusual spaces.",
+  "instruction_file": "SKILL.md",
+  "role": "Hygiene inspector",
+  "workflow_phase": "verify",
+  "input": {
+    "required": [
+      "draft path"
+    ],
+    "optional": [
+      "--fix",
+      "--output=cleaned.md"
+    ]
+  },
+  "output": {
+    "required": [
+      "hygiene report",
+      "optional cleaned file"
+    ],
+    "optional": []
+  },
+  "evidence_requirements": [
+    "Report only the deterministic result the command returns; never invent a model or provider call that did not occur."
+  ],
+  "permissions": [
+    "execute_commands",
+    "read_repository",
+    "write_repository"
+  ],
+  "stop_conditions": [
+    "Stop when required input is missing, when the command cannot run without changing existing behavior, or when a claimed capability is unavailable."
+  ],
+  "tool_free_mode": {
+    "available": true,
+    "behavior": "Provide the decision, artifact template, and exact unavailable capability; never claim a tool action occurred.",
+    "unavailable_statuses": [
+      "NOT_AVAILABLE",
+      "NOT_CONFIGURED",
+      "NOT_RUN",
+      "STALE",
+      "ERROR"
+    ]
+  },
+  "handoff_to": [
+    "hyv-final-check"
+  ]
+}

package/skills/hyv-hygiene/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Hygiene"
+  short_description: "Inspect text for zero-width characters, bidirectional controls, tag characters, and unusual spaces."
+  default_prompt: "Use $hyv-hygiene to inspect text for zero-width characters, bidirectional controls, tag characters, and unusual spaces."

package/skills/hyv-inspect-hidden-text/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-inspect-hidden-text
+description: Inspect hidden text controls with a non-mutating policy report.
+---
+
+# hyv-inspect-hidden-text
+
+Inspect hidden text controls with a non-mutating policy report. Findings are not watermark verdicts. An optional policy.json restricts which controls are reported.
+
+## Usage
+
+```text
+hyv inspect-hidden-text draft.md [policy.json]
+```
+
+## Behavior
+
+- Deterministic and local-first: this command never calls a provider and never sends drafts, samples, profiles, or telemetry to a service.
+- Commands that write use an explicit output path. Confirm that path before running the command.
+- This agent describes how to invoke the command and what it returns. It does not change command behavior or exit codes.
+
+## Handoff
+
+Run `hyv inspect-hidden-text` directly to execute the operation. Follow-on agents: hyv-apply-hidden-text-policy, hyv-final-check.

package/skills/hyv-inspect-hidden-text/agent.json

@@ -0,0 +1,48 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-inspect-hidden-text",
+  "title": "hyv-inspect-hidden-text",
+  "description": "Inspect hidden text controls with a non-mutating policy report.",
+  "instruction_file": "SKILL.md",
+  "role": "Hidden-text inspector",
+  "workflow_phase": "verify",
+  "input": {
+    "required": [
+      "draft path"
+    ],
+    "optional": [
+      "policy.json"
+    ]
+  },
+  "output": {
+    "required": [
+      "hidden-text inspection report"
+    ],
+    "optional": []
+  },
+  "evidence_requirements": [
+    "Report only the deterministic result the command returns; never invent a model or provider call that did not occur."
+  ],
+  "permissions": [
+    "execute_commands",
+    "read_repository"
+  ],
+  "stop_conditions": [
+    "Stop when required input is missing, when the command cannot run without changing existing behavior, or when a claimed capability is unavailable."
+  ],
+  "tool_free_mode": {
+    "available": true,
+    "behavior": "Provide the decision, artifact template, and exact unavailable capability; never claim a tool action occurred.",
+    "unavailable_statuses": [
+      "NOT_AVAILABLE",
+      "NOT_CONFIGURED",
+      "NOT_RUN",
+      "STALE",
+      "ERROR"
+    ]
+  },
+  "handoff_to": [
+    "hyv-apply-hidden-text-policy",
+    "hyv-final-check"
+  ]
+}

package/skills/hyv-inspect-hidden-text/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Inspect Hidden Text"
+  short_description: "Inspect hidden text controls with a non-mutating policy report."
+  default_prompt: "Use $hyv-inspect-hidden-text to inspect hidden text controls with a non-mutating policy report."

package/skills/hyv-learning/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-learning
+description: Inspect or explicitly mutate text-free local learning state for a profile.
+---
+
+# hyv-learning
+
+Inspect or explicitly mutate text-free local learning for a profile. show composes active preferences; inspect returns bounded event metadata; add/record write an explicit instruction with authority and provenance; ratify and supersede require Profile v3 plus an event id; migrate moves v2 history into v3; clear removes the identity state. Accepted-candidate learning requires a separately approved lifecycle transition.
+
+## Usage
+
+```text
+hyv learning <show|inspect|add|record|record-approved|ratify|supersede|migrate|clear> profile.json [value] [options]
+```
+
+## Behavior
+
+- Deterministic and local-first: this command never calls a provider and never sends drafts, samples, profiles, or telemetry to a service.
+- Commands that write use an explicit output path. Confirm that path before running the command.
+- This agent describes how to invoke the command and what it returns. It does not change command behavior or exit codes.
+
+## Handoff
+
+Run `hyv learning` directly to execute the operation.

package/skills/hyv-learning/agent.json

@@ -0,0 +1,48 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-learning",
+  "title": "hyv-learning",
+  "description": "Inspect or explicitly mutate text-free local learning state for a profile.",
+  "instruction_file": "SKILL.md",
+  "role": "Learning manager",
+  "workflow_phase": "learn",
+  "input": {
+    "required": [
+      "an action and profile path, or record-approved lifecycle inputs"
+    ],
+    "optional": [
+      "instruction, event id, or source/target as needed",
+      "--mutation-id, --authority, --provenance, --weight, --compatibility",
+      "capability stdin or file for record-approved"
+    ]
+  },
+  "output": {
+    "required": [
+      "learning mutation receipt or composition"
+    ],
+    "optional": []
+  },
+  "evidence_requirements": [
+    "Report only the deterministic result the command returns; never invent a model or provider call that did not occur."
+  ],
+  "permissions": [
+    "execute_commands",
+    "read_repository",
+    "write_repository"
+  ],
+  "stop_conditions": [
+    "Stop when required input is missing, when the command cannot run without changing existing behavior, or when a claimed capability is unavailable."
+  ],
+  "tool_free_mode": {
+    "available": true,
+    "behavior": "Provide the decision, artifact template, and exact unavailable capability; never claim a tool action occurred.",
+    "unavailable_statuses": [
+      "NOT_AVAILABLE",
+      "NOT_CONFIGURED",
+      "NOT_RUN",
+      "STALE",
+      "ERROR"
+    ]
+  },
+  "handoff_to": []
+}

package/skills/hyv-learning/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Learning"
+  short_description: "Inspect or explicitly mutate text-free local learning state for a profile."
+  default_prompt: "Use $hyv-learning to inspect or explicitly mutate text-free local learning state for a profile."

package/skills/hyv-lifecycle/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-lifecycle
+description: Advance and inspect the rewrite lifecycle: prepare-semantic, submit-verdict, inspect, validate-final-approval, finalize.
+---
+
+# hyv-lifecycle
+
+Advance and inspect the rewrite lifecycle. prepare-semantic builds an initial immutable artifact; submit-verdict records one verdict; inspect reads an artifact without exposing source or candidate hashes; validate-final-approval checks a capability against the trust context; finalize records an approved or rejected decision. Artifacts are immutable and exact replay is idempotent.
+
+## Usage
+
+```text
+hyv lifecycle <prepare-semantic|submit-verdict|inspect|validate-final-approval|finalize> ...
+```
+
+## Behavior
+
+- Deterministic and local-first: this command never calls a provider and never sends drafts, samples, profiles, or telemetry to a service.
+- Commands that write use an explicit output path. Confirm that path before running the command.
+- This agent describes how to invoke the command and what it returns. It does not change command behavior or exit codes.
+
+## Handoff
+
+Run `hyv lifecycle` directly to execute the operation. Follow-on agents: hyv-learning.