@holdyourvoice/hyv 3.3.4 → 3.4.0

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

@@ -0,0 +1,51 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-prepare-rewrite",
+  "title": "hyv-prepare-rewrite",
+  "description": "Prepare a local, versioned, fingerprint-bound rewrite task.",
+  "instruction_file": "SKILL.md",
+  "role": "Task preparer",
+  "workflow_phase": "plan",
+  "input": {
+    "required": [
+      "draft path",
+      "profile path",
+      "task output path"
+    ],
+    "optional": [
+      "copy-spec.json",
+      "writing-brief.json"
+    ]
+  },
+  "output": {
+    "required": [
+      "written task.json"
+    ],
+    "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-apply-rewrite"
+  ]
+}

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Prepare Rewrite"
+  short_description: "Prepare a local, versioned, fingerprint-bound rewrite task."
+  default_prompt: "Use $hyv-prepare-rewrite to prepare a local, versioned, fingerprint-bound rewrite task."

package/skills/hyv-profile/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-profile
+description: Build a portable VoiceDNA profile from at least two writing samples.
+---
+
+# hyv-profile
+
+Build a portable VoiceDNA profile from at least two writing samples. Samples stay in memory and are not saved into the profile; only measured voice features are written. The output path must be supplied first, followed by two or more sample paths. Use --avoid=phrase to add phrases that must never appear in later output.
+
+## Usage
+
+```text
+hyv profile profile.json sample-a.md sample-b.md [sample-c.md] [--avoid=phrase]
+```
+
+## 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 profile` directly to execute the operation. Follow-on agents: hyv-analyze, hyv-rewrite-prompt.

package/skills/hyv-profile/agent.json

@@ -0,0 +1,50 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-profile",
+  "title": "hyv-profile",
+  "description": "Build a portable VoiceDNA profile from at least two writing samples.",
+  "instruction_file": "SKILL.md",
+  "role": "Profile builder",
+  "workflow_phase": "analyze",
+  "input": {
+    "required": [
+      "profile output path",
+      "two or more sample paths"
+    ],
+    "optional": [
+      "--avoid=phrase avoid-list entries"
+    ]
+  },
+  "output": {
+    "required": [
+      "written profile.json"
+    ],
+    "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-analyze",
+    "hyv-rewrite-prompt"
+  ]
+}

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Profile"
+  short_description: "Build a portable VoiceDNA profile from at least two writing samples."
+  default_prompt: "Use $hyv-profile to build a portable voicedna profile from at least two writing samples."

package/skills/hyv-rebuild-writer-request/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-rebuild-writer-request
+description: Create the writer-only payload for a prepared rebuild task.
+---
+
+# hyv-rebuild-writer-request
+
+Create the writer-only payload for a prepared rebuild. It excludes the source draft, capability, profile body, and validation evidence.
+
+## Usage
+
+```text
+hyv rebuild-writer-request task.json writer-request.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 rebuild-writer-request` directly to execute the operation. Follow-on agents: hyv-apply-rebuild.

package/skills/hyv-rebuild-writer-request/agent.json

@@ -0,0 +1,47 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-rebuild-writer-request",
+  "title": "hyv-rebuild-writer-request",
+  "description": "Create the writer-only payload for a prepared rebuild task.",
+  "instruction_file": "SKILL.md",
+  "role": "Writer-request author",
+  "workflow_phase": "plan",
+  "input": {
+    "required": [
+      "task.json",
+      "writer-request output path"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "written writer-request.json"
+    ],
+    "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-apply-rebuild"
+  ]
+}

package/skills/hyv-rebuild-writer-request/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Rebuild Writer Request"
+  short_description: "Create the writer-only payload for a prepared rebuild task."
+  default_prompt: "Use $hyv-rebuild-writer-request to create the writer-only payload for a prepared rebuild task."

package/skills/hyv-reduce-judgment/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-reduce-judgment
+description: Reduce bound judgment envelopes into SHIP, EDIT, REBUILD, CLEAR, or ESCALATE.
+---
+
+# hyv-reduce-judgment
+
+Reduce bound judgment envelopes into SHIP, EDIT, REBUILD, CLEAR, or ESCALATE. It does not call a model.
+
+## Usage
+
+```text
+hyv reduce-judgment envelope.json envelope.json envelope.json [envelope.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 reduce-judgment` directly to execute the operation. Follow-on agents: hyv-prepare-rebuild.

package/skills/hyv-reduce-judgment/agent.json

@@ -0,0 +1,45 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-reduce-judgment",
+  "title": "hyv-reduce-judgment",
+  "description": "Reduce bound judgment envelopes into SHIP, EDIT, REBUILD, CLEAR, or ESCALATE.",
+  "instruction_file": "SKILL.md",
+  "role": "Judgment reducer",
+  "workflow_phase": "review",
+  "input": {
+    "required": [
+      "three or more judgment envelope.json paths"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "reduced decision"
+    ],
+    "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-prepare-rebuild"
+  ]
+}

package/skills/hyv-reduce-judgment/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Reduce Judgment"
+  short_description: "Reduce bound judgment envelopes into SHIP, EDIT, REBUILD, CLEAR, or ESCALATE."
+  default_prompt: "Use $hyv-reduce-judgment to reduce bound judgment envelopes into ship, edit, rebuild, clear, or escalate."

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

@@ -0,0 +1,24 @@
+---
+name: hyv-rewrite-prompt
+description: Create a constrained editing brief without rewriting the draft.
+---
+
+# hyv-rewrite-prompt
+
+Create a constrained editing brief. It does not rewrite the draft or call a model. The brief is printed to stdout for redirect into a markdown file.
+
+## Usage
+
+```text
+hyv rewrite-prompt draft.md profile.json [writing-brief.json] > rewrite-brief.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 rewrite-prompt` directly to execute the operation. Follow-on agents: hyv-prepare-rewrite.

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

@@ -0,0 +1,48 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-rewrite-prompt",
+  "title": "hyv-rewrite-prompt",
+  "description": "Create a constrained editing brief without rewriting the draft.",
+  "instruction_file": "SKILL.md",
+  "role": "Brief author",
+  "workflow_phase": "plan",
+  "input": {
+    "required": [
+      "draft path",
+      "profile path"
+    ],
+    "optional": [
+      "writing-brief.json"
+    ]
+  },
+  "output": {
+    "required": [
+      "markdown editing brief"
+    ],
+    "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-prepare-rewrite"
+  ]
+}

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Rewrite Prompt"
+  short_description: "Create a constrained editing brief without rewriting the draft."
+  default_prompt: "Use $hyv-rewrite-prompt to create a constrained editing brief without rewriting the draft."

package/skills/hyv-verify/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-verify
+description: Verify a revised candidate against an original draft and portable profile.
+---
+
+# hyv-verify
+
+Verify a revised candidate against an original draft and portable profile without changing learning state. Verification is read-only; learning changes require an explicit learning command or a separately approved lifecycle transition.
+
+## Usage
+
+```text
+hyv verify original.md candidate.md profile.json [writing-brief.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 verify` directly to execute the operation. Follow-on agents: hyv-lifecycle.

package/skills/hyv-verify/agent.json

@@ -0,0 +1,49 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-verify",
+  "title": "hyv-verify",
+  "description": "Verify a revised candidate against an original draft and portable profile.",
+  "instruction_file": "SKILL.md",
+  "role": "Verifier",
+  "workflow_phase": "verify",
+  "input": {
+    "required": [
+      "original path",
+      "candidate path",
+      "profile path"
+    ],
+    "optional": [
+      "writing-brief.json"
+    ]
+  },
+  "output": {
+    "required": [
+      "verification 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-lifecycle"
+  ]
+}

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Verify"
+  short_description: "Verify a revised candidate against an original draft and portable profile."
+  default_prompt: "Use $hyv-verify to verify a revised candidate against an original draft and portable profile."

package/skills/hyv-verify-spec/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-verify-spec
+description: Verify a candidate against the existing voice gates and a local CopySpec.
+---
+
+# hyv-verify-spec
+
+Verify a candidate against the existing voice gates and a local CopySpec. Immutable claims remain verbatim unless atoms are supplied; then each declared atom must remain. Prohibited claims fail closed.
+
+## Usage
+
+```text
+hyv verify-spec original.md candidate.md profile.json copy-spec.json [writing-brief.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 verify-spec` directly to execute the operation. Follow-on agents: hyv-lifecycle.

package/skills/hyv-verify-spec/agent.json

@@ -0,0 +1,50 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-verify-spec",
+  "title": "hyv-verify-spec",
+  "description": "Verify a candidate against the existing voice gates and a local CopySpec.",
+  "instruction_file": "SKILL.md",
+  "role": "CopySpec verifier",
+  "workflow_phase": "verify",
+  "input": {
+    "required": [
+      "original path",
+      "candidate path",
+      "profile path",
+      "copy-spec.json"
+    ],
+    "optional": [
+      "writing-brief.json"
+    ]
+  },
+  "output": {
+    "required": [
+      "verification report with CopySpec claim gate"
+    ],
+    "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-lifecycle"
+  ]
+}

package/skills/hyv-verify-spec/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Verify Spec"
+  short_description: "Verify a candidate against the existing voice gates and a local CopySpec."
+  default_prompt: "Use $hyv-verify-spec to verify a candidate against the existing voice gates and a local copyspec."