@nac3/forge-cli 0.2.0-alpha.1

package/dist/vault/store.js

@@ -0,0 +1,335 @@
+/**
+ * Vault store: persistent, atomic, slot-based credential storage.
+ *
+ * File layout under the configured config directory (typically
+ * ~/.yujin-forge/):
+ *
+ *   vault.salt          16 bytes of CSPRNG, written once per install
+ *   vault.json          JSON metadata + per-slot ciphertexts (base64)
+ *
+ * The salt is in its own file so it survives any corruption of
+ * vault.json -- worst case, the user re-enters their keys but does
+ * not need to regenerate the salt.
+ *
+ * Atomic writes: every persist writes to a `.tmp` sibling, fsyncs,
+ * then renames. Process death between write and rename leaves the
+ * old file intact; the orphan tmp is cleaned up on next open.
+ *
+ * Slot names: lowercase alphanumeric + underscore + hyphen,
+ * starting with a letter. Hard-rejected loudly otherwise.
+ *
+ * The list() surface returns metadata only: name, the first 4
+ * characters of the plaintext (so the user can confirm
+ * "yes, this is my key"), the plaintext length, and timestamps.
+ * Never returns ciphertext or plaintext beyond the prefix.
+ *
+ * Loud failures (per ROADMAP sec 12.2): every error path throws
+ * with a message explaining what went wrong.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { computeMachineFingerprint, deriveVaultKey, encrypt, decrypt, generateSalt, } from './crypto.js';
+import { inferKind, lookupCatalog, } from './catalog.js';
+/* Bump on every schema change. v1 = baseline (initial release).
+ * v2 = adds typed slots: { kind, expiry, last_test_at, last_test_ok }.
+ *      Read-side accepts v1 and migrates in-place to v2 on next
+ *      write. Write-side always emits v2. */
+export const VAULT_STORE_VERSION = 2;
+const VAULT_FILENAME = 'vault.json';
+const SALT_FILENAME = 'vault.salt';
+const TMP_SUFFIX = '.tmp';
+const SLOT_NAME_RE = /^[a-z][a-z0-9_-]*$/;
+export class Vault {
+    configDir;
+    salt;
+    key;
+    fingerprint;
+    slots;
+    constructor(configDir, salt, key, fingerprint, slots) {
+        this.configDir = configDir;
+        this.salt = salt;
+        this.key = key;
+        this.fingerprint = fingerprint;
+        this.slots = slots;
+    }
+    /**
+     * Open or create the vault at configDir.
+     *  - Creates configDir if missing.
+     *  - Reads or generates vault.salt.
+     *  - Derives the master key.
+     *  - Reads vault.json or starts with an empty slot set.
+     *  - Cleans up any orphan vault.json.tmp from a previous crashed write.
+     */
+    static async open(opts) {
+        if (!opts.configDir || !path.isAbsolute(opts.configDir)) {
+            throw new Error('Vault.open: configDir must be an absolute path (got ' + JSON.stringify(opts.configDir) + ')');
+        }
+        await fs.mkdir(opts.configDir, { recursive: true });
+        /* Clean up any orphan tmp file from a previous crashed write. */
+        const tmpPath = path.join(opts.configDir, VAULT_FILENAME + TMP_SUFFIX);
+        try {
+            await fs.unlink(tmpPath);
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                throw err;
+        }
+        const fingerprint = opts.fingerprint ?? computeMachineFingerprint();
+        /* Load or create salt. */
+        const saltPath = path.join(opts.configDir, SALT_FILENAME);
+        let salt;
+        try {
+            salt = await fs.readFile(saltPath);
+            if (salt.length < 16) {
+                throw new Error('vault.salt is corrupted (only ' + salt.length + ' bytes -- expected at least 16). '
+                    + 'Delete ' + saltPath + ' to reset the vault. Existing slots will be unreadable.');
+            }
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                throw err;
+            salt = generateSalt();
+            await atomicWrite(saltPath, salt);
+        }
+        const key = deriveVaultKey(fingerprint, salt);
+        /* Load slots or start empty. Accept v1 and v2 on read; the
+         * write path always emits the current VAULT_STORE_VERSION
+         * (v2 today). On v1 -> v2 read, slot kinds are inferred from
+         * the catalog and the file is rewritten on the next set/remove. */
+        const vaultPath = path.join(opts.configDir, VAULT_FILENAME);
+        let slots = {};
+        let needsMigrationRewrite = false;
+        try {
+            const raw = await fs.readFile(vaultPath, 'utf-8');
+            const parsedAny = JSON.parse(raw);
+            if (!parsedAny || typeof parsedAny !== 'object') {
+                throw new Error('vault.json is not a JSON object');
+            }
+            const ver = parsedAny.version;
+            if (ver !== 1 && ver !== VAULT_STORE_VERSION) {
+                throw new Error('vault.json version mismatch (got ' + String(ver) + ', expected '
+                    + VAULT_STORE_VERSION + ' or 1). The vault may have been written by a future Forge.');
+            }
+            if (!parsedAny.slots || typeof parsedAny.slots !== 'object') {
+                throw new Error('vault.json missing slots map');
+            }
+            const parsed = parsedAny;
+            slots = parsed.slots;
+            if (parsed.version === 1) {
+                /* Migrate v1 -> v2 by enriching each slot with its
+                 * inferred kind. The actual file rewrite happens on
+                 * the next write (lazy migration -- avoids touching
+                 * the file just by opening read-only paths). */
+                needsMigrationRewrite = true;
+                for (const name of Object.keys(slots)) {
+                    const slot = slots[name];
+                    if (!slot.kind)
+                        slot.kind = inferKind(name);
+                }
+            }
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== 'ENOENT')
+                throw err;
+            /* First install -- empty slots. Persist immediately so the
+               file exists and subsequent opens take the happy path. */
+        }
+        const vault = new Vault(opts.configDir, salt, key, fingerprint, slots);
+        /* Persist on first creation so vault.json exists from the start.
+         * Also persist on v1 -> v2 migration so the file is upgraded
+         * even when no slot write happens. */
+        if (!(await fileExists(vaultPath))) {
+            await vault.persist();
+        }
+        else if (needsMigrationRewrite) {
+            await vault.persist();
+        }
+        return vault;
+    }
+    /** True when the slot has a stored value. */
+    has(slotName) {
+        return Object.prototype.hasOwnProperty.call(this.slots, slotName);
+    }
+    /** Slot metadata for every slot, sorted by name. Never returns
+     *  ciphertext or plaintext beyond the 4-char prefix. */
+    list() {
+        return Object.entries(this.slots)
+            .map(([name, slot]) => ({
+            name,
+            prefix: slot.prefix,
+            length: slot.length,
+            created_at: slot.created_at,
+            updated_at: slot.updated_at,
+            kind: slot.kind ?? inferKind(name),
+            ...(slot.expiry ? { expiry: slot.expiry } : {}),
+            ...(slot.last_test_at ? { last_test_at: slot.last_test_at } : {}),
+            ...(typeof slot.last_test_ok === 'boolean' ? { last_test_ok: slot.last_test_ok } : {}),
+            in_catalog: lookupCatalog(name) !== undefined,
+        }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /** Encrypt + persist a plaintext into the named slot. Overwrites
+     *  if the slot already existed; the original created_at is
+     *  preserved while updated_at is bumped.
+     *
+     *  Options (all optional):
+     *    - kind:   override the kind (default = inferKind(slotName)).
+     *    - expiry: ISO 8601 expiry. When omitted, the existing
+     *              expiry is preserved (or cleared if you pass null).
+     */
+    async set(slotName, plaintext, opts = {}) {
+        if (!SLOT_NAME_RE.test(slotName)) {
+            throw new Error('vault slot name must match ' + SLOT_NAME_RE.source
+                + ' (lowercase alphanumeric + underscore + hyphen, starting with a letter). Got: '
+                + JSON.stringify(slotName));
+        }
+        if (typeof plaintext !== 'string' || plaintext.length === 0) {
+            throw new Error('vault.set requires a non-empty plaintext string for slot ' + slotName);
+        }
+        const blob = encrypt(plaintext, this.key);
+        const now = new Date().toISOString();
+        const previous = this.slots[slotName];
+        const kind = opts.kind ?? previous?.kind ?? inferKind(slotName);
+        let expiry;
+        if (opts.expiry === null)
+            expiry = undefined;
+        else if (opts.expiry !== undefined)
+            expiry = opts.expiry;
+        else
+            expiry = previous?.expiry;
+        this.slots[slotName] = {
+            ciphertext_b64: blob.toString('base64'),
+            prefix: plaintext.slice(0, 4),
+            length: plaintext.length,
+            created_at: previous?.created_at ?? now,
+            updated_at: now,
+            kind,
+            ...(expiry ? { expiry } : {}),
+            /* Reset last_test_* on set; a new value invalidates the
+               old test outcome. */
+        };
+        await this.persist();
+    }
+    /** Decrypt and return the plaintext for a slot. Throws if the
+     *  slot is missing or the ciphertext is corrupted. This is the
+     *  ONLY path that surfaces plaintext, and it is server-side only
+     *  -- never called from a route handler that returns to the
+     *  browser. */
+    get(slotName) {
+        const slot = this.slots[slotName];
+        if (!slot) {
+            throw new Error('vault slot not found: ' + slotName);
+        }
+        const blob = Buffer.from(slot.ciphertext_b64, 'base64');
+        return decrypt(blob, this.key);
+    }
+    /** Remove a slot. Returns true if the slot existed, false
+     *  otherwise. Persists on success. */
+    async remove(slotName) {
+        if (!Object.prototype.hasOwnProperty.call(this.slots, slotName)) {
+            return false;
+        }
+        delete this.slots[slotName];
+        await this.persist();
+        return true;
+    }
+    /** Rotate a slot: replace its plaintext with a new one. Equivalent
+     *  to set() but expresses intent ("the old value is gone") in
+     *  CLI surfaces. Same created_at preservation behaviour as set. */
+    async rotate(slotName, newPlaintext) {
+        await this.set(slotName, newPlaintext);
+    }
+    /** Probe the stored credential against the external service.
+     *  Looks up the catalog entry for `slotName`. When no test
+     *  function is defined, returns ok=true with detail "no probe
+     *  registered" so the UI can still report something. Persists
+     *  last_test_at + last_test_ok on the slot. */
+    async test(slotName, opts = {}) {
+        const slot = this.slots[slotName];
+        if (!slot)
+            throw new Error('vault slot not found: ' + slotName);
+        const entry = lookupCatalog(slotName);
+        const timeoutMs = opts.timeoutMs ?? 5000;
+        let result;
+        if (!entry || !entry.test) {
+            result = { ok: true, status: 0, latency_ms: 0,
+                detail: entry ? 'no probe registered for this slot' : 'custom slot -- no probe' };
+        }
+        else {
+            const plaintext = this.get(slotName);
+            try {
+                result = await entry.test(plaintext, { timeoutMs });
+            }
+            catch (err) {
+                result = {
+                    ok: false, status: 0, latency_ms: 0,
+                    detail: err instanceof Error ? err.message : String(err),
+                };
+            }
+        }
+        slot.last_test_at = new Date().toISOString();
+        slot.last_test_ok = result.ok;
+        await this.persist();
+        return result;
+    }
+    /** Total number of slots currently stored. */
+    size() {
+        return Object.keys(this.slots).length;
+    }
+    /** Read-only view of the directory where this vault lives. */
+    configDirPath() {
+        return this.configDir;
+    }
+    async persist() {
+        const vaultPath = path.join(this.configDir, VAULT_FILENAME);
+        /* Ensure every slot has a kind before persisting; legacy
+           v1 slots loaded just now may lack it. */
+        for (const name of Object.keys(this.slots)) {
+            const s = this.slots[name];
+            if (!s.kind)
+                s.kind = inferKind(name);
+        }
+        const payload = {
+            version: VAULT_STORE_VERSION,
+            slots: this.slots,
+        };
+        const body = Buffer.from(JSON.stringify(payload, null, 2), 'utf-8');
+        await atomicWrite(vaultPath, body);
+    }
+}
+/**
+ * Write data to targetPath atomically. Layout: write to
+ * `<targetPath>.tmp`, fsync, rename. A crash between fsync and
+ * rename leaves the original intact and orphans the tmp; Vault.open
+ * cleans the orphan up on next launch.
+ */
+async function atomicWrite(targetPath, data) {
+    const tmpPath = targetPath + TMP_SUFFIX;
+    await fs.writeFile(tmpPath, data, { mode: 0o600 });
+    /* fsync to make sure the bytes hit the disk before we rename --
+       otherwise a power loss between write and rename could leave the
+       "renamed" file pointing to an empty inode on some filesystems. */
+    const fh = await fs.open(tmpPath, 'r+');
+    try {
+        await fh.sync();
+    }
+    finally {
+        await fh.close();
+    }
+    await fs.rename(tmpPath, targetPath);
+}
+async function fileExists(p) {
+    try {
+        await fs.stat(p);
+        return true;
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return false;
+        throw err;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/vault/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/vault/store.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Yujin Forge CLI version. Single source of truth -- package.json
+ * reads from this at publish time (the publish script copies it
+ * into the npm metadata) so we don't end up with two versions
+ * drifting.
+ */
+export declare const VERSION = "0.2.0-alpha.1";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,OAAO,kBAAkB,CAAC"}

package/dist/version.js

@@ -0,0 +1,8 @@
+/**
+ * Yujin Forge CLI version. Single source of truth -- package.json
+ * reads from this at publish time (the publish script copies it
+ * into the npm metadata) so we don't end up with two versions
+ * drifting.
+ */
+export const VERSION = '0.2.0-alpha.1';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC"}

package/dist/voice/chunker.d.ts

@@ -0,0 +1,43 @@
+/**
+ * TTS chunker (V1.24 of HITO 1).
+ *
+ * Splits a paragraph or section of spoken text into TTS-friendly
+ * chunks so the panel can pipeline fetches and start playing the
+ * first chunk while later chunks are still being synthesised by
+ * the provider. End-to-end voice latency on a 500-word section
+ * drops from ~3s (single round-trip) to ~600ms (first sentence
+ * arrives + plays while the rest streams in).
+ *
+ * Sentence boundary detection is regex-based + conservative:
+ *
+ *   - '.', '!', '?' followed by whitespace (and not preceded by
+ *     a single uppercase letter or common abbreviation) end a
+ *     sentence.
+ *   - ';' ends a clause-level break only when the buffered
+ *     chunk is already longer than ~120 chars (so we don't
+ *     over-fragment short sentences).
+ *   - Double newline always ends a chunk (paragraph boundary).
+ *
+ * After sentence splitting, we still cap each chunk at
+ * `maxLen` chars (default 300). Anything over that gets
+ * subdivided on the nearest whitespace.
+ *
+ * Pure function. No node / no DOM. Easy to unit-test.
+ *
+ * ASCII-only.
+ */
+export interface ChunkOptions {
+    /** Maximum characters per chunk after sentence splitting.
+     *  Default 300. Anything between 200 and 500 is sensible:
+     *  too short and the provider per-call overhead dominates;
+     *  too long and the first-audio latency we are trying to
+     *  hide reappears. */
+    maxLen?: number;
+    /** When a clause-level break (;) appears, only honour it if
+     *  the buffered chunk is already longer than this. Default
+     *  120. */
+    semicolonBreakAtLen?: number;
+}
+/** Split `text` into sentence-aware chunks. */
+export declare function splitIntoTtsChunks(text: string, opts?: ChunkOptions): string[];
+//# sourceMappingURL=chunker.d.ts.map

package/dist/voice/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/voice/chunker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,WAAW,YAAY;IAC3B;;;;0BAIsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;eAEW;IACX,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAmCD,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,MAAM,EAAE,CAqElF"}

package/dist/voice/chunker.js

@@ -0,0 +1,133 @@
+/**
+ * TTS chunker (V1.24 of HITO 1).
+ *
+ * Splits a paragraph or section of spoken text into TTS-friendly
+ * chunks so the panel can pipeline fetches and start playing the
+ * first chunk while later chunks are still being synthesised by
+ * the provider. End-to-end voice latency on a 500-word section
+ * drops from ~3s (single round-trip) to ~600ms (first sentence
+ * arrives + plays while the rest streams in).
+ *
+ * Sentence boundary detection is regex-based + conservative:
+ *
+ *   - '.', '!', '?' followed by whitespace (and not preceded by
+ *     a single uppercase letter or common abbreviation) end a
+ *     sentence.
+ *   - ';' ends a clause-level break only when the buffered
+ *     chunk is already longer than ~120 chars (so we don't
+ *     over-fragment short sentences).
+ *   - Double newline always ends a chunk (paragraph boundary).
+ *
+ * After sentence splitting, we still cap each chunk at
+ * `maxLen` chars (default 300). Anything over that gets
+ * subdivided on the nearest whitespace.
+ *
+ * Pure function. No node / no DOM. Easy to unit-test.
+ *
+ * ASCII-only.
+ */
+const DEFAULT_MAX_LEN = 300;
+/** Lowered from 120 to 80 after V1.24 testing -- 120 was too
+ *  aggressive at keeping long compound sentences together;
+ *  80 splits on semicolons in real spec prose. */
+const DEFAULT_SEMICOLON_BREAK = 80;
+/** Multi-letter abbreviations whose trailing period must NOT
+ *  split a sentence. Case-insensitive. */
+const MULTI_LETTER_ABBREVIATIONS = new Set([
+    'sr', 'sra', 'srta', 'dr', 'dra', 'prof', 'mr', 'mrs', 'ms',
+    'st', 'ave', 'av', 'no', 'num', 'pag', 'pg', 'vol', 'ed',
+    'cap', 'fig', 'ej', 'etc', 'aprox', 'lic',
+    /* Common in spec / dev docs. */
+    'js', 'ts', 'py', 'sh', 'md', 'html', 'css', 'cli',
+    'api', 'rfc', 'iso', 'utc', 'utf', 'cpu', 'gpu', 'ram',
+]);
+/** True when the character(s) immediately before the boundary
+ *  position belong to a known abbreviation. Single-letter
+ *  abbreviations only count when the letter is uppercase
+ *  (e.g. "T. S. Eliot" -- but NOT "a. b. c."). */
+function isAbbreviationBefore(text, dotPos) {
+    let start = dotPos - 1;
+    while (start >= 0 && /[a-zA-Z]/.test(text.charAt(start)))
+        start -= 1;
+    start += 1;
+    if (start >= dotPos)
+        return false;
+    const word = text.slice(start, dotPos);
+    if (word.length === 1) {
+        return /[A-Z]/.test(word);
+    }
+    return MULTI_LETTER_ABBREVIATIONS.has(word.toLowerCase());
+}
+/** Split `text` into sentence-aware chunks. */
+export function splitIntoTtsChunks(text, opts = {}) {
+    const maxLen = Math.max(40, opts.maxLen ?? DEFAULT_MAX_LEN);
+    const semiBreak = Math.max(40, opts.semicolonBreakAtLen ?? DEFAULT_SEMICOLON_BREAK);
+    const trimmed = text.replace(/\s+/g, ' ').trim();
+    if (!trimmed)
+        return [];
+    const chunks = [];
+    let buf = '';
+    let i = 0;
+    function flush() {
+        const t = buf.trim();
+        if (t)
+            chunks.push(t);
+        buf = '';
+    }
+    function flushAtMaxLen() {
+        /* Long chunk without a natural break -- subdivide on the
+           nearest whitespace before maxLen. */
+        while (buf.length > maxLen) {
+            let cut = buf.lastIndexOf(' ', maxLen);
+            if (cut < maxLen / 2)
+                cut = maxLen;
+            const piece = buf.slice(0, cut).trim();
+            if (piece)
+                chunks.push(piece);
+            buf = buf.slice(cut).trimStart();
+        }
+    }
+    while (i < trimmed.length) {
+        const ch = trimmed.charAt(i);
+        buf += ch;
+        /* Hard paragraph break already collapsed by the initial
+           /\s+/ replace; we therefore only see single spaces +
+           sentence punctuation as natural cut points. */
+        const isSentencePunct = ch === '.' || ch === '!' || ch === '?';
+        const isSemicolon = ch === ';';
+        if (isSentencePunct) {
+            const next = trimmed.charAt(i + 1);
+            if (next === '' || next === ' ') {
+                /* Period of abbreviation? Then do not split. */
+                if (ch === '.' && isAbbreviationBefore(trimmed, i)) {
+                    i += 1;
+                    continue;
+                }
+                /* Decimal in the middle of digits ("1.23")? No split. */
+                if (ch === '.' && /\d/.test(trimmed.charAt(i - 1) || '')
+                    && /\d/.test(trimmed.charAt(i + 1) || '')) {
+                    i += 1;
+                    continue;
+                }
+                i += 1;
+                if (trimmed.charAt(i) === ' ')
+                    i += 1;
+                flush();
+                continue;
+            }
+        }
+        else if (isSemicolon && buf.length >= semiBreak) {
+            i += 1;
+            if (trimmed.charAt(i) === ' ')
+                i += 1;
+            flush();
+            continue;
+        }
+        i += 1;
+        if (buf.length > maxLen)
+            flushAtMaxLen();
+    }
+    flush();
+    return chunks;
+}
+//# sourceMappingURL=chunker.js.map

package/dist/voice/chunker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.js","sourceRoot":"","sources":["../../src/voice/chunker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAeH,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B;;kDAEkD;AAClD,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAEnC;0CAC0C;AAC1C,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IACzC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI;IAC3D,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI;IACxD,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK;IACzC,gCAAgC;IAChC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;IAClD,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;CACvD,CAAC,CAAC;AAEH;;;kDAGkD;AAClD,SAAS,oBAAoB,CAAC,IAAY,EAAE,MAAc;IACxD,IAAI,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC;IACvB,OAAO,KAAK,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;IACrE,KAAK,IAAI,CAAC,CAAC;IACX,IAAI,KAAK,IAAI,MAAM;QAAE,OAAO,KAAK,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,OAAqB,EAAE;IACtE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,mBAAmB,IAAI,uBAAuB,CAAC,CAAC;IAEpF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,SAAS,KAAK;QACZ,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,GAAG,GAAG,EAAE,CAAC;IACX,CAAC;IAED,SAAS,aAAa;QACpB;+CACuC;QACvC,OAAO,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;YAC3B,IAAI,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACvC,IAAI,GAAG,GAAG,MAAM,GAAG,CAAC;gBAAE,GAAG,GAAG,MAAM,CAAC;YACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YACvC,IAAI,KAAK;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9B,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7B,GAAG,IAAI,EAAE,CAAC;QAEV;;yDAEiD;QACjD,MAAM,eAAe,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,CAAC;QAC/D,MAAM,WAAW,GAAG,EAAE,KAAK,GAAG,CAAC;QAE/B,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACnC,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBAChC,gDAAgD;gBAChD,IAAI,EAAE,KAAK,GAAG,IAAI,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC;oBACnD,CAAC,IAAI,CAAC,CAAC;oBACP,SAAS;gBACX,CAAC;gBACD,yDAAyD;gBACzD,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;uBACjD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;oBAC9C,CAAC,IAAI,CAAC,CAAC;oBACP,SAAS;gBACX,CAAC;gBACD,CAAC,IAAI,CAAC,CAAC;gBACP,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;oBAAE,CAAC,IAAI,CAAC,CAAC;gBACtC,KAAK,EAAE,CAAC;gBACR,SAAS;YACX,CAAC;QACH,CAAC;aAAM,IAAI,WAAW,IAAI,GAAG,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;YAClD,CAAC,IAAI,CAAC,CAAC;YACP,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;gBAAE,CAAC,IAAI,CAAC,CAAC;YACtC,KAAK,EAAE,CAAC;YACR,SAAS;QACX,CAAC;QACD,CAAC,IAAI,CAAC,CAAC;QACP,IAAI,GAAG,CAAC,MAAM,GAAG,MAAM;YAAE,aAAa,EAAE,CAAC;IAC3C,CAAC;IACD,KAAK,EAAE,CAAC;IACR,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/voice/config.d.ts

@@ -0,0 +1,14 @@
+import { type WakeMatchResult } from './wake.js';
+export declare const VOICE_CONFIG_VERSION = 1;
+export interface VoiceConfig {
+    version: 1;
+    /** Extra aliases the user wants matched (e.g. "koe", "yoo-jin"). */
+    wake_aliases_extra: string[];
+    /** Levenshtein cap. 0 = exact-only. 2 = default. */
+    wake_max_distance: number;
+}
+export declare function readVoiceConfig(): Promise<VoiceConfig>;
+export declare function writeVoiceConfig(cfg: VoiceConfig): Promise<void>;
+/** Match a wake-word against the user's configured alias set. */
+export declare function matchConfiguredWakeWord(input: string): Promise<WakeMatchResult>;
+//# sourceMappingURL=config.d.ts.map

package/dist/voice/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/voice/config.ts"],"names":[],"mappings":"AAYA,OAAO,EAA+B,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAE9E,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,CAAC;IACX,oEAAoE;IACpE,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAWD,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CAe5D;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAItE;AAED,iEAAiE;AACjE,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAIrF"}

package/dist/voice/config.js

@@ -0,0 +1,51 @@
+/**
+ * Voice configuration -- per-device, plain JSON (not a secret).
+ *
+ * Lives at ~/.yujin-forge/voice.json. Holds the user's extra
+ * wake-word aliases + max Levenshtein distance. Defaults are
+ * applied at read time; an absent file is fine.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { mergeAliases, matchWakeWord } from './wake.js';
+export const VOICE_CONFIG_VERSION = 1;
+function voiceConfigPath() {
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    return path.join(home, '.yujin-forge', 'voice.json');
+}
+function defaultConfig() {
+    return { version: 1, wake_aliases_extra: [], wake_max_distance: 2 };
+}
+export async function readVoiceConfig() {
+    const p = voiceConfigPath();
+    try {
+        const buf = await fs.readFile(p, 'utf8');
+        const obj = JSON.parse(buf);
+        return {
+            version: 1,
+            wake_aliases_extra: Array.isArray(obj.wake_aliases_extra) ? obj.wake_aliases_extra : [],
+            wake_max_distance: typeof obj.wake_max_distance === 'number' ? obj.wake_max_distance : 2,
+        };
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT')
+            return defaultConfig();
+        throw err;
+    }
+}
+export async function writeVoiceConfig(cfg) {
+    const p = voiceConfigPath();
+    await fs.mkdir(path.dirname(p), { recursive: true });
+    await fs.writeFile(p, JSON.stringify(cfg, null, 2) + '\n', 'utf8');
+}
+/** Match a wake-word against the user's configured alias set. */
+export async function matchConfiguredWakeWord(input) {
+    const cfg = await readVoiceConfig();
+    const aliases = mergeAliases(cfg.wake_aliases_extra);
+    return matchWakeWord(input, { aliases, maxDistance: cfg.wake_max_distance });
+}
+//# sourceMappingURL=config.js.map

package/dist/voice/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/voice/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAwB,MAAM,WAAW,CAAC;AAE9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAUtC,SAAS,eAAe;IACtB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IACzE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,kBAAkB,EAAE,EAAE,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,CAAC,GAAG,eAAe,EAAE,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;QACpD,OAAO;YACL,OAAO,EAAE,CAAC;YACV,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE;YACvF,iBAAiB,EAAE,OAAO,GAAG,CAAC,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;SACzF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,aAAa,EAAE,CAAC;QAC9C,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAgB;IACrD,MAAM,CAAC,GAAG,eAAe,EAAE,CAAC;IAC5B,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAAa;IACzD,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACrD,OAAO,aAAa,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAC/E,CAAC"}