holycodex 0.16.9 → 0.16.10-dev.112.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "holycodex",
-  "version": "0.16.9",
+  "version": "0.16.10-dev.112.1",
   "bin": {
     "holycodex": "./dist/index.js",
     "holycodex-agent": "./dist/agent.js"
@@ -24,7 +24,7 @@
   },
   "release": {
     "schemaVersion": "holycodex-release-v1",
-    "channel": "stable",
-    "sourceSha": "dd98b3f8cd4e010ceac2543fd2a995f8343b916c"
+    "channel": "dev",
+    "sourceSha": "028126563881e7ad951f4fd06f1eb76e2ac48a51"
   }
 }

package/dist/assets/plugin/skills/code-review/SKILL.md

@@ -1,8 +0,0 @@
----
-name: code-review
-description: Use after implementation when Root needs adversarial code review and bounded repair to a fixed point.
----
-
-Inspect the integrated implementation against the `Reviewer.code` contract.
-Check callers, contracts, tests, and generated artifacts. Repair defects inside
-the review surface and return findings, repairs, checks, and remaining risk.

package/dist/assets/plugin/skills/code-review/agents/openai.yaml

@@ -1,6 +0,0 @@
-interface:
-  display_name: "Code review"
-  short_description: "Review one implementation result to a fixed point."
-  default_prompt: "Open the code review workflow for this invocation."
-policy:
-  allow_implicit_invocation: false

package/dist/assets/plugin/skills/operations/SKILL.md

@@ -1,10 +0,0 @@
----
-name: operations
-description: Use for a Worker.operations exact-ref/SHA observation Assignment.
----
-
-Load [babysit-ci](../babysit-ci/SKILL.md) before observing the supplied exact ref
-and SHA. Return the required terminal gate evidence and any unavailable or
-ambiguous blocker within the Assignment's observation-only authority. Include
-target-branch or pull-request mergeability evidence when the repository or
-provider exposes it; green CI alone does not prove mergeability.

package/dist/assets/plugin/skills/operations/agents/openai.yaml

@@ -1,6 +0,0 @@
-interface:
-  display_name: "Operations"
-  short_description: "Observe exact-ref CI or release state to terminal evidence."
-  default_prompt: "Open the terminal operations observation workflow for this invocation."
-policy:
-  allow_implicit_invocation: false

package/dist/assets/plugin/skills/plan/SKILL.md

@@ -1,10 +0,0 @@
----
-name: plan
-description: Use when unresolved architecture, scope, coordination, or material risk requires an implementation-ready Plan.
----
-
-Resolve the current material choices into an implementation-ready Plan with
-scope, owners, seams, data and control flow, policy, recovery, compatibility,
-acceptance evidence, and a bounded proof route. Keep planning proportional:
-trivial work can proceed without a Plan. Persist the canonical revision through
-the semantic Plan operation.

package/dist/assets/plugin/skills/plan/agents/openai.yaml

@@ -1,6 +0,0 @@
-interface:
-  display_name: "Plan"
-  short_description: "Resolve material scope and architecture choices before work."
-  default_prompt: "Open the planning workflow for this invocation."
-policy:
-  allow_implicit_invocation: false

package/dist/assets/plugin/skills/plan-review/SKILL.md

@@ -1,7 +0,0 @@
----
-name: plan-review
-description: Use when a complete Plan needs adversarial feasibility, order, risk, and proof review.
----
-
-Inspect the complete Plan for feasibility, ordering, risk, and proof. Return
-findings and proposed corrections without changing the canonical Plan or source.

package/dist/assets/plugin/skills/plan-review/agents/openai.yaml

@@ -1,6 +0,0 @@
-interface:
-  display_name: "Plan review"
-  short_description: "Review one complete plan to a fixed point."
-  default_prompt: "Open the plan review workflow for this invocation."
-policy:
-  allow_implicit_invocation: false

package/dist/assets/plugin/skills/programming/SKILL.md

@@ -1,7 +0,0 @@
----
-name: programming
-description: Use when Root has decided a bounded implementation seam with known acceptance behavior.
----
-
-Implement only the decided seam and prove its acceptance behavior at the least
-brittle observable boundary.

package/dist/assets/plugin/skills/programming/agents/openai.yaml

@@ -1,6 +0,0 @@
-interface:
-  display_name: "Programming"
-  short_description: "Implement one decided seam with proportional proof."
-  default_prompt: "Open the bounded programming workflow for this invocation."
-policy:
-  allow_implicit_invocation: false

package/dist/assets/plugin/skills/stop-slop/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Hardik Pandya
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/assets/plugin/skills/stop-slop/SKILL.md

@@ -1,9 +0,0 @@
----
-name: stop-slop
-description: Use when assigned prose should lose predictable AI writing patterns while preserving voice.
----
-
-Edit only the assigned prose. Remove filler, formulaic structure, vague claims,
-passive voice, and repeated rhythm while preserving meaning and voice. Use the
-linked [phrase](references/phrases.md), [structure](references/structures.md),
-and [example](references/examples.md) references when needed.

package/dist/assets/plugin/skills/stop-slop/agents/openai.yaml

@@ -1,6 +0,0 @@
-interface:
-  display_name: "Stop Slop"
-  short_description: "Edit assigned prose to remove predictable AI patterns."
-  default_prompt: "Open the assigned prose editing workflow for this invocation."
-policy:
-  allow_implicit_invocation: true

package/dist/assets/plugin/skills/stop-slop/references/examples.md

@@ -1,69 +0,0 @@
-# Before/After Examples
-
-## Example 1: Throat-Clearing + Binary Contrast
-
-**Before:**
-
-> "Here's the thing: building products is hard. Not because the technology is complex. Because people are complex. Let that sink in."
-
-**After:**
-
-> "Building products is hard. Technology is manageable. People aren't."
-
-**Changes:** Removed opener, binary contrast structure, and emphasis crutch. Direct statements.
-
----
-
-## Example 2: Filler + Unnecessary Reassurance
-
-**Before:**
-
-> "It turns out that most teams struggle with alignment. The uncomfortable truth is that nobody wants to admit they're confused. And that's okay."
-
-**After:**
-
-> "Teams struggle with alignment. Nobody admits confusion."
-
-**Changes:** Cut hedging ("most"), removed throat-clearing phrases, deleted permission-granting ending.
-
----
-
-## Example 3: Business Jargon Stack
-
-**Before:**
-
-> "In today's fast-paced landscape, we need to lean into discomfort and navigate uncertainty with clarity. This matters because your competition isn't waiting."
-
-**After:**
-
-> "Move faster. Your competition is."
-
-**Changes:** Eliminated jargon entirely. Core message in six words.
-
----
-
-## Example 4: Dramatic Fragmentation
-
-**Before:**
-
-> "Speed. Quality. Cost. You can only pick two. That's it. That's the tradeoff."
-
-**After:**
-
-> "Speed, quality, cost—pick two."
-
-**Changes:** Single sentence. No performative emphasis.
-
----
-
-## Example 5: Rhetorical Setup
-
-**Before:**
-
-> "What if I told you that the best teams don't optimize for productivity? Here's what I mean: they optimize for learning. Think about it."
-
-**After:**
-
-> "The best teams optimize for learning, not productivity."
-
-**Changes:** Direct claim. No rhetorical scaffolding.

package/dist/assets/plugin/skills/stop-slop/references/phrases.md

@@ -1,128 +0,0 @@
-# Phrases to Remove
-
-## Throat-Clearing Openers
-
-Remove these announcement phrases. State the content directly.
-
-- "Here's the thing:"
-- "Here's what [X]"
-- "Here's this [X]"
-- "Here's that [X]"
-- "Here's why [X]"
-- "The uncomfortable truth is"
-- "It turns out"
-- "The real [X] is"
-- "Let me be clear"
-- "The truth is,"
-- "I'll say it again:"
-- "I'm going to be honest"
-- "Can we talk about"
-- "Here's what I find interesting"
-- "Here's the problem though"
-
-Any "here's what/this/that" construction is throat-clearing before the point. Cut it and state the point.
-
-## Emphasis Crutches
-
-These add no meaning. Delete them.
-
-- "Full stop." / "Period."
-- "Let that sink in."
-- "This matters because"
-- "Make no mistake"
-- "Here's why that matters"
-
-## Business Jargon
-
-Replace with plain language.
-
-| Avoid                 | Use instead            |
-| --------------------- | ---------------------- |
-| Navigate (challenges) | Handle, address        |
-| Unpack (analysis)     | Explain, examine       |
-| Lean into             | Accept, embrace        |
-| Landscape (context)   | Situation, field       |
-| Game-changer          | Significant, important |
-| Double down           | Commit, increase       |
-| Deep dive             | Analysis, examination  |
-| Take a step back      | Reconsider             |
-| Moving forward        | Next, from now         |
-| Circle back           | Return to, revisit     |
-| On the same page      | Aligned, agreed        |
-
-## Adverbs
-
-Kill all adverbs. No -ly words. No softeners, no intensifiers, no hedges.
-
-Specific offenders:
-
-- "really"
-- "just"
-- "literally"
-- "genuinely"
-- "honestly"
-- "simply"
-- "actually"
-- "deeply"
-- "truly"
-- "fundamentally"
-- "inherently"
-- "inevitably"
-- "interestingly"
-- "importantly"
-- "crucially"
-
-Also cut these filler phrases:
-
-- "At its core"
-- "In today's [X]"
-- "It's worth noting"
-- "At the end of the day"
-- "When it comes to"
-- "In a world where"
-- "The reality is"
-
-## Meta-Commentary
-
-Remove self-referential asides. The essay should move, not announce its own structure.
-
-- "Hint:"
-- "Plot twist:" / "Spoiler:"
-- "You already know this, but"
-- "But that's another post"
-- "X is a feature, not a bug"
-- "Dressed up as"
-- "The rest of this essay explains..."
-- "Let me walk you through..."
-- "In this section, we'll..."
-- "As we'll see..."
-- "I want to explore..."
-
-## Performative Emphasis
-
-False intimacy or manufactured sincerity:
-
-- "creeps in"
-- "I promise"
-- "They exist, I promise"
-
-## Telling Instead of Showing
-
-Announcing difficulty or significance rather than demonstrating it:
-
-- "This is genuinely hard"
-- "This is what leadership actually looks like"
-- "This is what X actually looks like"
-- "actually matters"
-
-## Vague Declaratives
-
-Sentences that announce importance without naming the specific thing. Kill these.
-
-- "The reasons are structural"
-- "The implications are significant"
-- "This is the deepest problem"
-- "The stakes are high"
-- "The consequences are real"
-
-If a sentence says something is important/deep/structural without showing the specific thing, cut it or replace it with the specific thing.

package/dist/assets/plugin/skills/stop-slop/references/structures.md

@@ -1,134 +0,0 @@
-# Structures to Avoid
-
-## Binary Contrasts
-
-These create false drama. State the point directly.
-
-| Pattern                                                       | Problem                        |
-| ------------------------------------------------------------- | ------------------------------ |
-| "Not because X. Because Y." / "Not because X, but because Y." | Telegraphed reversal           |
-| "[X] isn't the problem. [Y] is."                              | Formulaic reframe              |
-| "The answer isn't X. It's Y."                                 | Predictable pivot              |
-| "It feels like X. It's actually Y."                           | Setup/reveal cliche            |
-| "The question isn't X. It's Y."                               | Rhetorical misdirection        |
-| "Not X. But Y." / "not X, it's Y" / "isn't X, it's Y"         | Mechanical contrast            |
-| "It's not this. It's that."                                   | Same formula, different words  |
-| "stops being X and starts being Y"                            | False transformation arc       |
-| "doesn't mean X, but actually Y"                              | Negation-then-assertion crutch |
-| "is about X but not Y"                                        | False distinction              |
-| "not just X but also Y"                                       | Additive hedge                 |
-
-**Instead:** State Y directly. "The problem is Y." "Y matters here." Drop the negation entirely.
-
-## Negative Listing
-
-Listing what something is _not_ before revealing what it _is_. A rhetorical striptease.
-
-| Pattern                               | Problem                           |
-| ------------------------------------- | --------------------------------- |
-| "Not a X... Not a Y... A Z."          | Dramatic buildup through negation |
-| "It wasn't X. It wasn't Y. It was Z." | Same structure, past tense        |
-
-**Instead:** State Z. The reader doesn't need the runway.
-
-## Dramatic Fragmentation
-
-Sentence fragments for emphasis read as manufactured profundity.
-
-| Pattern                                  | Problem                 |
-| ---------------------------------------- | ----------------------- |
-| "[Noun]. That's it. That's the [thing]." | Performative simplicity |
-| "X. And Y. And Z."                       | Staccato drama          |
-| "This unlocks something. [Word]."        | Artificial revelation   |
-
-**Instead:** Complete sentences. Trust content over presentation.
-
-## Rhetorical Setups
-
-These announce insight rather than deliver it.
-
-| Pattern               | Problem                |
-| --------------------- | ---------------------- |
-| "What if [reframe]?"  | Socratic posturing     |
-| "Here's what I mean:" | Redundant preview      |
-| "Think about it:"     | Condescending prompt   |
-| "And that's okay."    | Unnecessary permission |
-
-**Instead:** Make the point. Let readers draw conclusions.
-
-## Formulaic Constructions
-
-| Pattern                   | Problem                     |
-| ------------------------- | --------------------------- |
-| "By the time X, I was Y." | Narrative template          |
-| "X that isn't Y"          | Indirect. Say "X is broken" |
-
-## False Agency
-
-Giving inanimate things human verbs. Complaints don't "become" fixes. Bets don't "live or die." Decisions don't "emerge." A person does something to make those things happen. AI loves this because it avoids naming the actor.
-
-| Pattern                         | Problem                                                           |
-| ------------------------------- | ----------------------------------------------------------------- |
-| "a complaint becomes a fix"     | The complaint did nothing. Someone fixed it.                      |
-| "a bet lives or dies in days"   | Bets don't have lifespans. Someone kills the project or ships it. |
-| "the decision emerges"          | Decisions don't emerge. Someone decides.                          |
-| "the culture shifts"            | Cultures don't shift on their own. People change behavior.        |
-| "the conversation moves toward" | Conversations don't move. Someone steers.                         |
-| "the data tells us"             | Data sits there. Someone reads it and draws a conclusion.         |
-| "the market rewards"            | Markets don't reward. Buyers pay for things.                      |
-
-**Instead:** Name the human. "The team fixed it that week" beats "the complaint becomes a fix." If no specific person fits, use "you" to put the reader in the seat.
-
-## Narrator-from-a-Distance
-
-Floating above the scene instead of putting the reader in it.
-
-| Pattern                   | Problem                 |
-| ------------------------- | ----------------------- |
-| "Nobody designed this."   | Disembodied observation |
-| "This happens because..." | Lecturer voice          |
-| "This is why..."          | Same                    |
-| "People tend to..."       | Armchair sociologist    |
-
-**Instead:** Put the reader in the room. "You don't sit down one day and decide to..." beats "Nobody designed this."
-
-## Passive Voice
-
-Every sentence needs a subject doing something. Passive voice hides the actor and drains energy.
-
-| Pattern                    | Fix                  |
-| -------------------------- | -------------------- |
-| "X was created"            | Name who created it  |
-| "It is believed that"      | Name who believes it |
-| "Mistakes were made"       | Name who made them   |
-| "The decision was reached" | Name who decided     |
-
-**Instead:** Find the actor. Put them at the front of the sentence.
-
-## Sentence Starters to Avoid
-
-| Pattern                                                         | Fix                                             |
-| --------------------------------------------------------------- | ----------------------------------------------- |
-| Sentences starting with What, When, Where, Which, Who, Why, How | Restructure. Lead with the subject or the verb. |
-| Paragraphs starting with "So"                                   | Start with content                              |
-| Sentences starting with "Look,"                                 | Remove                                          |
-
-Wh- openers become a crutch. "What makes this hard is..." becomes "The constraint is..." or better, name the specific constraint.
-
-## Rhythm Patterns
-
-| Pattern                        | Fix                                                 |
-| ------------------------------ | --------------------------------------------------- |
-| Three-item lists               | Use two items or one                                |
-| Questions answered immediately | Let questions breathe or cut them                   |
-| Every paragraph ends punchily  | Vary endings                                        |
-| Em-dashes                      | Remove. Use commas or periods. No em dashes at all. |
-| Staccato fragmentation         | Don't stack short punchy sentences                  |
-| "Not always. Not perfectly."   | Hedging disguised as reassurance                    |
-
-## Word Patterns
-
-| Pattern                                                                                               | Problem                                                    |
-| ----------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
-| Lazy extremes (every, always, never, everyone, everybody, nobody)                                     | False authority. Use specifics instead of sweeping claims. |
-| All adverbs (-ly words, "really," "just," "literally," "genuinely," "honestly," "simply," "actually") | Empty emphasis. See phrases.md for full list.              |

package/dist/assets/plugin/skills/writing-instructions/SKILL-MECHANICS.md

@@ -1,16 +0,0 @@
-# Skill mechanics
-
-Use a skill for a distinct conditional workflow or tool capability. Keep its
-description short and specific enough to distinguish the invocation from nearby
-skills. Avoid broad triggers that compete for ordinary work; audit implicit
-invocation against the other skills the receiver can load.
-
-Keep the main body focused on the shared outcome, boundaries, and acceptance
-criteria. Link branch-specific tool knowledge or uncommon procedures from the
-condition that needs them, so only the selected branch loads its detail. Do not
-split a short coherent rule merely to create more files.
-
-Keep display and invocation metadata in agents/openai.yaml and behavior in its
-single authoritative source. References should supply a missing decision or
-mechanic, not copies of the body or global policy. Preserve provenance and
-license attribution under the original upstream names when renaming a skill.