@holdyourvoice/hyv 3.3.5 → 3.4.0

package/skills/hyv-lifecycle/agent.json

@@ -0,0 +1,48 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-lifecycle",
+  "title": "hyv-lifecycle",
+  "description": "Advance and inspect the rewrite lifecycle: prepare-semantic, submit-verdict, inspect, validate-final-approval, finalize.",
+  "instruction_file": "SKILL.md",
+  "role": "Lifecycle manager",
+  "workflow_phase": "review",
+  "input": {
+    "required": [
+      "a lifecycle subcommand and its arguments"
+    ],
+    "optional": [
+      "capability stdin or file where required"
+    ]
+  },
+  "output": {
+    "required": [
+      "lifecycle artifact or decision result"
+    ],
+    "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-learning"
+  ]
+}

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Lifecycle"
+  short_description: "Advance and inspect the rewrite lifecycle: prepare-semantic, submit-verdict, inspect, validate-final-approval, finalize."
+  default_prompt: "Use $hyv-lifecycle to advance and inspect the rewrite lifecycle: prepare-semantic, submit-verdict, inspect, validate-final-approval, finalize."

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

@@ -0,0 +1,24 @@
+---
+name: hyv-logic-lint
+description: Run the deterministic document-coherence gate for topic drift, unanchored inference, and internal contradictions.
+---
+
+# hyv-logic-lint
+
+Run the deterministic document-coherence gate. It detects configured topic drift, unanchored inference, and direct internal contradictions; it does not verify facts or approve publication.
+
+## Usage
+
+```text
+hyv logic-lint <draft|-> [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 logic-lint` directly to execute the operation. Follow-on agents: hyv-verify.

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

@@ -0,0 +1,47 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-logic-lint",
+  "title": "hyv-logic-lint",
+  "description": "Run the deterministic document-coherence gate for topic drift, unanchored inference, and internal contradictions.",
+  "instruction_file": "SKILL.md",
+  "role": "Logic linter",
+  "workflow_phase": "verify",
+  "input": {
+    "required": [
+      "draft path"
+    ],
+    "optional": [
+      "writing-brief.json"
+    ]
+  },
+  "output": {
+    "required": [
+      "logic 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-logic-lint/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Logic Lint"
+  short_description: "Run the deterministic document-coherence gate for topic drift, unanchored inference, and internal contradictions."
+  default_prompt: "Use $hyv-logic-lint to run the deterministic document-coherence gate for topic drift, unanchored inference, and internal contradictions."

package/skills/hyv-mcp/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-mcp
+description: Start the local Hold Your Voice MCP server.
+---
+
+# hyv-mcp
+
+Start the local Hold Your Voice MCP server over stdio. The server registers the writing tools for MCP-capable hosts. It sends no drafts, samples, profiles, or telemetry to any service.
+
+## Usage
+
+```text
+hyv mcp
+```
+
+## 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 mcp` directly to execute the operation.

package/skills/hyv-mcp/agent.json

@@ -0,0 +1,43 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-mcp",
+  "title": "hyv-mcp",
+  "description": "Start the local Hold Your Voice MCP server.",
+  "instruction_file": "SKILL.md",
+  "role": "MCP server",
+  "workflow_phase": "run",
+  "input": {
+    "required": [
+      "no arguments (run hyv mcp)"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "running MCP server on stdio"
+    ],
+    "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-mcp/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Mcp"
+  short_description: "Start the local Hold Your Voice MCP server."
+  default_prompt: "Use $hyv-mcp to start the local hold your voice mcp server."

package/skills/hyv-patterns/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-patterns
+description: List the exact AI Editor rules that run.
+---
+
+# hyv-patterns
+
+List the exact AI Editor rules that run in this package: the ruleset version and the deterministic catalog with reconstructable regular-expression source, flags, and sentence or physical-line scope.
+
+## Usage
+
+```text
+hyv patterns
+```
+
+## 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 patterns` directly to execute the operation.

package/skills/hyv-patterns/agent.json

@@ -0,0 +1,43 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-patterns",
+  "title": "hyv-patterns",
+  "description": "List the exact AI Editor rules that run.",
+  "instruction_file": "SKILL.md",
+  "role": "Pattern catalog",
+  "workflow_phase": "analyze",
+  "input": {
+    "required": [
+      "no arguments (run hyv patterns)"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "ruleset version and exact deterministic catalog"
+    ],
+    "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-patterns/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Patterns"
+  short_description: "List the exact AI Editor rules that run."
+  default_prompt: "Use $hyv-patterns to list the exact ai editor rules that run."

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

@@ -0,0 +1,24 @@
+---
+name: hyv-prepare-judgment
+description: Prepare a versioned pre-edit or post-candidate judgment task.
+---
+
+# hyv-prepare-judgment
+
+Prepare a versioned pre-edit or post-candidate judgment task. It does not call a model. The post-candidate stage requires a candidate path.
+
+## Usage
+
+```text
+hyv prepare-judgment pre-edit|post-candidate kind draft.md profile.json task.json [candidate.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 prepare-judgment` directly to execute the operation. Follow-on agents: hyv-reduce-judgment.

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

@@ -0,0 +1,52 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-prepare-judgment",
+  "title": "hyv-prepare-judgment",
+  "description": "Prepare a versioned pre-edit or post-candidate judgment task.",
+  "instruction_file": "SKILL.md",
+  "role": "Judgment preparer",
+  "workflow_phase": "plan",
+  "input": {
+    "required": [
+      "stage (pre-edit|post-candidate)",
+      "kind",
+      "draft path",
+      "profile path",
+      "task output path"
+    ],
+    "optional": [
+      "candidate.md"
+    ]
+  },
+  "output": {
+    "required": [
+      "written judgment 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-reduce-judgment"
+  ]
+}

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Prepare Judgment"
+  short_description: "Prepare a versioned pre-edit or post-candidate judgment task."
+  default_prompt: "Use $hyv-prepare-judgment to prepare a versioned pre-edit or post-candidate judgment task."

package/skills/hyv-prepare-rebuild/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-prepare-rebuild
+description: Prepare a rebuild task only after an upstream REBUILD recommendation, a CopySpec, and a signed rebuild-authorization capability.
+---
+
+# hyv-prepare-rebuild
+
+Prepare a rebuild task only after an upstream REBUILD recommendation, a CopySpec, and a signed rebuild-authorization capability. Capability input requires host-guaranteed sensitive-input redaction. Callers cannot self-select rebuild.
+
+## Usage
+
+```text
+hyv prepare-rebuild draft.md profile.json reduction.json copy-spec.json task.json [writing-brief.json] [--recomposition-policy policy.json] (--capability-stdin|--capability-file 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 prepare-rebuild` directly to execute the operation. Follow-on agents: hyv-apply-rebuild.

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

@@ -0,0 +1,54 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-prepare-rebuild",
+  "title": "hyv-prepare-rebuild",
+  "description": "Prepare a rebuild task only after an upstream REBUILD recommendation, a CopySpec, and a signed rebuild-authorization capability.",
+  "instruction_file": "SKILL.md",
+  "role": "Rebuild preparer",
+  "workflow_phase": "plan",
+  "input": {
+    "required": [
+      "draft path",
+      "profile path",
+      "reduction.json",
+      "copy-spec.json",
+      "task output path"
+    ],
+    "optional": [
+      "writing-brief.json",
+      "--recomposition-policy policy.json",
+      "capability stdin or file"
+    ]
+  },
+  "output": {
+    "required": [
+      "written rebuild 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-rebuild"
+  ]
+}

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Prepare Rebuild"
+  short_description: "Prepare a rebuild task only after an upstream REBUILD recommendation, a CopySpec, and a signed rebuild-authorization capability."
+  default_prompt: "Use $hyv-prepare-rebuild to prepare a rebuild task only after an upstream rebuild recommendation, a copyspec, and a signed rebuild-authorization capability."

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

@@ -0,0 +1,24 @@
+---
+name: hyv-prepare-rewrite
+description: Prepare a local, versioned, fingerprint-bound rewrite task.
+---
+
+# hyv-prepare-rewrite
+
+Prepare a local, versioned rewrite task written to the named output path. The caller may forward it to a provider; doing so shares the draft and must be an explicit choice. This command never calls a provider itself.
+
+## Usage
+
+```text
+hyv prepare-rewrite draft.md profile.json task.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 prepare-rewrite` directly to execute the operation. Follow-on agents: hyv-apply-rewrite.

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.