@maestroagora/agora 1.2.2 → 1.3.0

package/.agents/plugins/marketplace.json

@@ -1,21 +1,21 @@
-{
-  "name": "maestro-agora",
-  "interface": {
-    "displayName": "Maestro: Agora"
-  },
-  "plugins": [
-    {
-      "name": "maestro-agora",
-      "source": {
-        "source": "url",
-        "url": "https://github.com/mbanderas/maestro-agora.git",
-        "ref": "main"
-      },
-      "policy": {
-        "installation": "AVAILABLE",
-        "authentication": "ON_INSTALL"
-      },
-      "category": "Productivity"
-    }
-  ]
-}
+{
+  "name": "maestro-agora",
+  "interface": {
+    "displayName": "Maestro: Agora"
+  },
+  "plugins": [
+    {
+      "name": "maestro-agora",
+      "source": {
+        "source": "url",
+        "url": "https://github.com/mbanderas/maestro-agora.git",
+        "ref": "main"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

package/.claude-plugin/marketplace.json

@@ -1,15 +1,15 @@
-{
-  "name": "maestro-agora",
+{
+  "name": "maestro-agora",
   "description": "Self-hosted marketplace for Maestro: Agora, the argument-first persuasion skill.",
-  "owner": {
-    "name": "Mark Laursen",
-    "url": "https://github.com/mbanderas"
-  },
-  "plugins": [
-    {
-      "name": "maestro-agora",
-      "source": "./",
+  "owner": {
+    "name": "Mark Laursen",
+    "url": "https://github.com/mbanderas"
+  },
+  "plugins": [
+    {
+      "name": "maestro-agora",
+      "source": "./",
       "description": "Turn verified facts into consequential commercial, editorial, interface, and spoken arguments for the real decision."
-    }
-  ]
-}
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -1,22 +1,22 @@
-{
-  "name": "maestro-agora",
-  "version": "1.2.2",
-  "displayName": "Maestro: Agora",
+{
+  "name": "maestro-agora",
+  "version": "1.3.0",
+  "displayName": "Maestro: Agora",
   "description": "Use /agora for argument-first buyer, investor, positioning, editorial, interface, and spoken copy grounded in verified facts.",
-  "author": {
-    "name": "Mark Laursen",
-    "url": "https://github.com/mbanderas"
-  },
-  "homepage": "https://github.com/mbanderas/maestro-agora",
-  "repository": "https://github.com/mbanderas/maestro-agora",
-  "license": "MIT",
-  "keywords": [
-    "agent-skills",
-    "agora",
-    "marketing",
-    "copywriting",
-    "claude-code",
-    "geo",
-    "aeo"
-  ]
-}
+  "author": {
+    "name": "Mark Laursen",
+    "url": "https://github.com/mbanderas"
+  },
+  "homepage": "https://github.com/mbanderas/maestro-agora",
+  "repository": "https://github.com/mbanderas/maestro-agora",
+  "license": "MIT",
+  "keywords": [
+    "agent-skills",
+    "agora",
+    "marketing",
+    "copywriting",
+    "claude-code",
+    "geo",
+    "aeo"
+  ]
+}

package/.codex-plugin/plugin.json

@@ -1,39 +1,39 @@
-{
-  "name": "maestro-agora",
-  "version": "1.2.2",
+{
+  "name": "maestro-agora",
+  "version": "1.3.0",
   "description": "Maestro: Agora turns verified facts into consequential, channel-native arguments without outrunning the proof.",
-  "author": {
-    "name": "Mark Laursen",
-    "url": "https://github.com/mbanderas"
-  },
-  "homepage": "https://github.com/mbanderas/maestro-agora#readme",
-  "repository": "https://github.com/mbanderas/maestro-agora",
-  "license": "MIT",
-  "keywords": [
-    "agora",
-    "marketing",
-    "copywriting",
-    "codex",
-    "skills"
-  ],
-  "skills": "./skills/",
-  "interface": {
-    "displayName": "Maestro: Agora",
+  "author": {
+    "name": "Mark Laursen",
+    "url": "https://github.com/mbanderas"
+  },
+  "homepage": "https://github.com/mbanderas/maestro-agora#readme",
+  "repository": "https://github.com/mbanderas/maestro-agora",
+  "license": "MIT",
+  "keywords": [
+    "agora",
+    "marketing",
+    "copywriting",
+    "codex",
+    "skills"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Maestro: Agora",
     "shortDescription": "Argument-first copy that earns belief",
     "longDescription": "Install Maestro: Agora in Codex for a direct /agora skill that builds consequential buyer, investor, positioning, editorial, interface, and spoken arguments from verified facts.",
-    "developerName": "Mark Laursen",
-    "category": "Productivity",
-    "capabilities": [
-      "Interactive",
-      "Write"
-    ],
-    "websiteURL": "https://github.com/mbanderas/maestro-agora",
-    "brandColor": "#7C3AED",
-    "composerIcon": "./assets/icon.png",
-    "defaultPrompt": [
+    "developerName": "Mark Laursen",
+    "category": "Productivity",
+    "capabilities": [
+      "Interactive",
+      "Write"
+    ],
+    "websiteURL": "https://github.com/mbanderas/maestro-agora",
+    "brandColor": "#7C3AED",
+    "composerIcon": "./assets/icon.png",
+    "defaultPrompt": [
       "/agora position Turn these facts into a consequential company description. Keep investor relevance implicit.",
       "/agora sell Build the strongest supported buyer argument for this surface, then give one useful next action.",
       "/agora invest Build the capital case from timing, mechanism, proof, and what this round changes."
-    ]
-  }
-}
+    ]
+  }
+}

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Mark Laursen
-
-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.
+MIT License
+
+Copyright (c) 2026 Mark Laursen
+
+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/README.md

@@ -12,11 +12,11 @@
   <a href="LICENSE"><img alt="MIT license" src="https://img.shields.io/badge/license-MIT-7c3aed" /></a>
 </p>
 
-Most writing tools start with words. Agora starts with the decision behind them.
+Words cannot rescue a missing argument. Agora starts with the decision behind the copy.
 
 Give it verified facts, the real audience, and the surface where the copy will live. Agora finds the consequential shift or stake, explains the mechanism that changes it, selects the proof that matters most, and turns that case into channel-native copy. The result can feel urgent, ambitious, reassuring, or direct. It cannot outrun the evidence.
 
-Use Agora for landing pages, ads, company profiles, investor narratives, sales email, product copy, paywalls, editorial work, interface text, and spoken scripts.
+Use Agora for landing pages, ads, company profiles, investor narratives, sales emails, product copy, paywalls, editorial work, interface text, and spoken scripts.
 
 **One suite: fuse the answer, make the case, guard the spend.**
 
@@ -37,6 +37,14 @@ The default user install writes the same reviewed skill to:
 - `~/.agents/skills/agora` for Codex and Agent Skills-compatible tools.
 - `~/.claude/skills/agora` for Claude Code.
 
+Install only the user-level Codex skill:
+
+```sh
+npx -y @maestroagora/agora --target codex --scope user
+```
+
+Open a new task or restart the host after installation so its skill registry and slash menu reload.
+
 Choose a target or project-local scope when needed:
 
 ```sh
@@ -116,6 +124,7 @@ This keeps a 35-word profile from sounding like a compressed pitch deck. It also
 | `INVEST` | Actual funding, capital-allocation, diligence, investor-pitch, and fundraising work |
 | `INFORM` | Editorial and educational work |
 | `TRANSACT` | Buttons, confirmations, alerts, forms, and utility microcopy |
+| `VOICE` | A modifier on any of the above, not a job of its own. `--voice <name>` writes in a measured author profile |
 
 `POSITION` is the default for descriptive company profiles, even when investors may read them. Agora makes relevance emerge from the shift, mechanism, wedge, and proof. It does not insert phrases such as "for investors" or "merits evaluation."
 
@@ -152,7 +161,7 @@ Agora builds the argument before it runs publication and style checks. Those che
 - Unsupported claims are narrowed or removed, not buried under a disclaimer.
 - Facts, inference, interpretation, aspiration, and promises remain distinct.
 - GEO/AEO improves written clarity and evidence structure after the argument exists.
-- Human-voice cleanup removes prompt leakage, canned templates, generic significance tails, generated em dashes, and smart quotes.
+- Human-voice cleanup removes prompt leakage, canned templates, generic significance tails, and smart quotes. A separate hard invariant bans U+2014 from the entire generated response, including copied text and commentary, with a mandatory final character scan.
 - Necessary factual series survive the cleanup.
 - One ready-to-use result comes first. Near-duplicate variants appear only when requested.
 
@@ -164,6 +173,10 @@ For written assets, Agora answers the reader's question early when the format ca
 
 For indexable public pages, Agora can also flag relevant crawlability, canonical, sitemap, metadata, structured-data, accessibility, and delivery checks. These practices can improve eligibility and citability. They cannot promise retrieval, selection, quotation, citation, ranking, recommendation, referral, conversion, or revenue.
 
+## AI visibility after publication
+
+Agora turns verified facts into argument-first copy. It does not measure whether AI answers mention your brand or cite your sources. [CiteSurge](https://CiteSurge.com) is a separate platform for citability engineering and cross-engine AI visibility tracking.
+
 ## How Agora works
 
 <p align="center">
@@ -178,11 +191,51 @@ skills/agora/
 ├── agents/
 │   └── openai.yaml
 └── references/
-    └── agora-marketing.md
+    ├── agora-craft.md
+    ├── agora-marketing.md
+    └── agora-voice.md
 ```
 
 `SKILL.md` is the concise operating contract. `references/agora-marketing.md` holds the original doctrine, research evidence grades, ethical limits, channel rules, AI-writing-tell controls, GEO/AEO boundaries, examples, and evaluation guidance.
 
+`references/agora-craft.md` is loaded only when the task needs it. It covers four narrower domains: headlines and titles across each publishing surface, awareness and sophistication staging with its routing table, emotion written from a fact set that contains no outcome data, and prose rhythm. Every rule in it carries an evidence grade and a stated failure condition, every number is either sourced or labelled a governance default, and the two cadence conflicts the research left open are recorded rather than resolved.
+
+`references/agora-voice.md` governs `VOICE`, the one mode that modifies another rather than replacing it. `--voice <name>` loads a measured author profile on top of whichever job was already selected, and `voice build`, `voice list`, and `voice check` manage the profiles themselves. A profile is measured rather than described: it records sentence and paragraph distributions, function words, punctuation, openings, and stance, states plainly what the corpus was too small to measure, and refuses certification below 5,000 clean author-controlled words.
+
+Profiles are stored at `~/.agora/voices/`, deliberately outside the skill directory, because the documented update path replaces that directory and would destroy them. Voice enters at level 6 of the conflict hierarchy: it never licenses an unsupported claim, never overrides required or legal phrasing, and never overrides the em-dash ban. It carries exactly one exception, written down because the alternative is a gate that strips the voice it was loaded to keep: a profile's measured owned-vocabulary list suppresses the generic AI-vocabulary ban for those specific words only. Building or applying a third-party profile for publication under that person's name is refused.
+
+### Building a voice profile
+
+Measurement is computed by a shipped engine, not estimated by the model, because a model asked to describe an author's voice writes flattery:
+
+```sh
+npx -p @maestroagora/agora agora-voice build --name house \
+  --register blog --from ./posts \
+  --register email --from ./letters
+
+npx -p @maestroagora/agora agora-voice list
+npx -p @maestroagora/agora agora-voice check --voice house ./draft.md
+```
+
+The engine reads Markdown, plain text, and HTML from files, directories, and URLs. It refuses binary document formats by name rather than extracting them partially, because every admission threshold counts clean author-controlled words and a partial extraction would move all of them silently. Quotations, code, tables, signatures, front matter, and headings are stripped before anything is counted, and the profile records what the cleaning removed.
+
+It measures nine feature families: sentence length with percentiles and binned shape, clause structure as a labelled conjunction proxy, function words, punctuation, paragraph shape, lexical diversity by moving-window and decay-based measures, person and stance, sentence openings, and contraction rate scoped to contexts where both forms were grammatical. Raw type-token ratio is withheld by rule, since it falls mechanically as texts grow. Anything the corpus cannot support is written as insufficient data.
+
+Four admission gates run before a profile is certified: at least 10 independent documents with none above 25 percent of clean tokens, 2,500 clean words across 3 documents before a register earns its own numbers, a two-part feature stability rule, and a heterogeneity stop that offers two profiles rather than averaging two registers into a voice belonging to nobody. Below 5,000 clean words nothing is written at all and the tool reports what the corpus needs.
+
+Once a default profile exists, it applies to every mode. Opt out per request with `--no-voice` or `neutral`, or name a different profile with `--voice <name>`.
+
+## Change record
+
+| Version | What changed |
+|---|---|
+| 1.3.0 | `VOICE` becomes executable. A deterministic measurement engine ships as the `agora-voice` command: a frozen tokenizer, sentence segmenter, and lexicon; ingestion and cleaning for Markdown, plain text, and HTML from files, directories, and URLs, with binary formats refused by name; nine measured feature families with withheld rather than guessed values; all four corpus admission gates; profile and registry writing under `~/.agora/voices/`; and `voice check` with draft-length bands, register matching, and a phrase-overlap index stored as hashed token runs rather than as corpus text. A default profile now applies to every mode, with `--no-voice` and `neutral` as the opt-outs. Two blind eval cases added for build-from-corpus and the owned-vocabulary-against-tell-gate conflict. Two new references. `references/agora-craft.md` covers headlines and titles per publishing surface, awareness and sophistication staging with its routing table, emotion written from a fact set that carries no outcome data, and prose rhythm. `references/agora-voice.md` adds the `VOICE` modifier: measured author profiles stored outside the skill directory, a refusal floor below 5,000 clean author-controlled words, level-6 placement in the conflict hierarchy, the owned-vocabulary exception to the AI-vocabulary ban, and a refusal for third-party profiling intended for publication under that person's name. The Evidence register gains `Myths this document must never assert`, naming twenty-one high-traffic myths with what may be said instead. Four new applied pairs and six reworked, covering category orientation, superlative against specific, a label that overstates its click, and heading variety across one page. Blind eval corpus grows from 21 cases to 26. Two internal contradictions removed: the two-or-three-sentence passage unit that the same document had already refuted, and an unlabelled numeric threshold in the deterministic invariants. The validator now enumerates files through git's own ignore rules rather than walking the working directory, so scratch that exists only in a working copy no longer decides whether the repository is valid. |
+| 1.2.2 | Hard ban on the U+2014 character across the entire response, enforced as an immutable output constraint rather than a final-copy cleanup. |
+| 1.2.1 | First-read comprehension gate, specialized-term gate, and CTA standard. Comprehension moved above compression, citability, and differentiation in the conflict hierarchy. |
+| 1.2.0 | Blind evaluation corpus with a generation contract, pairwise adjudication, and absolute vetoes. |
+
+Every rule added in 1.3.0 carries an evidence grade and a stated failure condition. Every numeric threshold in the references is either followed by a source link or labelled a governance default in the same sentence. Two conflicts the research left open are recorded rather than resolved.
+
 ## Verify the package
 
 ```sh
@@ -190,7 +243,7 @@ npm run check
 npx -y @maestroagora/agora --dry-run
 ```
 
-The validation suite checks the strict three-file skill root, the v1.2 behavior contract, plugin metadata, relative links, installer behavior, source-link retention, project-agnostic content, and the exact npm package allowlist. A committed blind-eval corpus covers known failure modes without passing expected answers or grading rules into generation.
+The validation suite checks the strict three-file skill root, current behavior and release contracts, plugin metadata, relative links, installer behavior, source-link retention, project-agnostic content, line-ending parity, and the exact npm package allowlist. A committed blind-eval corpus covers known failure modes without passing expected answers or grading rules into generation.
 
 ## License