agentreceipt-voice 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ayush Pund
+
+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

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# agentreceipt-voice
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A small toolkit for people who dictate a lot. One install, four tools, each also available as its own package.
+
+```sh
+npx agentreceipt-voice packs export developer     # ready-made snippets and dictionary words
+npx agentreceipt-voice check my-dictionary.csv    # see what the app would skip, before you import
+npx agentreceipt-voice vocab ./my-repo            # build a dictionary from the names in your code
+npx agentreceipt-voice snippets init              # keep snippets as files in git
+```
+
+| Command | What it does | Also available as |
+|---|---|---|
+| `check <file>` | Checks a dictionary CSV or a snippets JSON and lists every row the app would silently skip | [agentreceipt-voice-check](https://www.npmjs.com/package/agentreceipt-voice-check) |
+| `packs list` / `packs export` | Writes ready-made snippet and dictionary packs for developers, founders, support and sales | [agentreceipt-voice-packs](https://www.npmjs.com/package/agentreceipt-voice-packs) |
+| `snippets init` / `snippets build` | Keeps your snippets and dictionary as plain files in a repo, and builds the import files | [agentreceipt-voice-snippets](https://www.npmjs.com/package/agentreceipt-voice-snippets) |
+| `vocab [folder]` | Scans a repo for package names and identifiers dictation gets wrong, and writes a dictionary CSV | [agentreceipt-voice-vocab](https://www.npmjs.com/package/agentreceipt-voice-vocab) |
+
+Everything runs on your computer. Nothing is uploaded.
+
+## Good to know
+
+- **Unofficial.** This is not made by, or affiliated with, any dictation app. The files follow the bulk-import format that Wispr Flow's help centre describes: a dictionary CSV with no header row (one column, or `misspelling,correction`), and a snippets JSON array of `{ "name", "text" }`, with at most 1,000 entries and 3 MB per file. It has not been tested inside the app itself, so run `check` and look at the app's own import preview before you confirm.
+- **Triggers start with "insert".** Dictation apps match triggers as whole words, so a plain phrase like "bug report" would expand in the middle of normal speech. "insert bug report" will not.
+- If the app changes its import rules, `check` will need to change too.
+
+## Use it from code
+
+```js
+import { check, packs } from 'agentreceipt-voice';
+
+const result = check.checkDictionary('Supabase\nsuper base,Supabase\n');
+console.log(result.ok, result.valid.length);
+console.log(packs.listPacks());
+```
+
+## Licence
+
+MIT. Made by the team behind [AgentReceipt](https://www.agentreceipt.online), which records what AI coding agents change in your code.

package/bin/cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { run } from '../src/cli.js';
+
+process.exitCode = await run(process.argv.slice(2));

package/package.json

@@ -1,6 +1,27 @@
 {
   "name": "agentreceipt-voice",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "A toolkit for voice dictation power users: check import files, keep snippets as code, install ready-made snippet packs, and build a dictionary from your repo. One command, four tools. Unofficial; works with the Wispr Flow import format.",
+  "keywords": ["dictation", "voice", "snippets", "dictionary", "wispr-flow", "speech-to-text", "voice-typing", "developer-tools", "toolkit"],
+  "license": "MIT",
+  "author": "Ayush Pund <founders@agentreceipt.online> (https://www.agentreceipt.online)",
+  "homepage": "https://www.agentreceipt.online",
+  "bugs": { "email": "founders@agentreceipt.online" },
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./package.json": "./package.json"
+  },
+  "bin": { "agentreceipt-voice": "bin/cli.js" },
+  "files": ["bin", "src", "README.md", "LICENSE"],
+  "dependencies": {
+    "agentreceipt-voice-check": "^0.1.0",
+    "agentreceipt-voice-packs": "^0.1.0",
+    "agentreceipt-voice-snippets": "^0.1.0",
+    "agentreceipt-voice-vocab": "^0.1.0"
+  },
+  "engines": { "node": ">=18" },
+  "publishConfig": { "access": "public" },
+  "scripts": { "test": "node --test" }
+}

package/src/cli.js

@@ -0,0 +1,30 @@
+import { readFileSync } from 'node:fs';
+import { run as check } from 'agentreceipt-voice-check/cli';
+import { run as packs } from 'agentreceipt-voice-packs/cli';
+import { run as snippets } from 'agentreceipt-voice-snippets/cli';
+import { run as vocab } from 'agentreceipt-voice-vocab/cli';
+
+const USAGE = `agentreceipt-voice <command> [options]
+
+  check <file>...        check a dictionary CSV or snippets JSON before you import it
+  packs list | export    ready-made snippet and dictionary packs (developer, founder, support, sales)
+  snippets init | build  keep snippets as files in git and build the import files
+  vocab [folder]         build a dictionary CSV from the names in a code repository
+
+Each command is also its own package: agentreceipt-voice-check, -packs, -snippets and -vocab.
+Run a command with --help for its options. Unofficial: not made by or affiliated with any dictation app.`;
+
+const COMMANDS = { check, packs, snippets, vocab };
+
+export async function run(argv, io = { out: (s) => process.stdout.write(s), err: (s) => process.stderr.write(s) }) {
+  const [cmd, ...rest] = argv;
+  if (cmd === '--version' || cmd === '-v') {
+    const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+    io.out(`${pkg.version}\n`);
+    return 0;
+  }
+  if (!cmd || cmd === '--help' || cmd === '-h') return (cmd ? io.out : io.err)(`${USAGE}\n`), cmd ? 0 : 2;
+  const fn = COMMANDS[cmd];
+  if (!fn) return io.err(`Unknown command "${cmd}".\n${USAGE}\n`), 2;
+  return fn(rest, io);
+}

package/src/index.js

@@ -0,0 +1,5 @@
+// The parent package: one install that brings its four children, which can also be used alone.
+export * as check from 'agentreceipt-voice-check';
+export * as snippets from 'agentreceipt-voice-snippets';
+export * as packs from 'agentreceipt-voice-packs';
+export * as vocab from 'agentreceipt-voice-vocab';