@holdyourvoice/hyv 3.3.4 → 3.4.0

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.

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.