@nac3/forge-cli 0.2.0-alpha.9 → 0.2.1-alpha.60

package/dist/wiring/discover.js

@@ -0,0 +1,383 @@
+/**
+ * Yujin Forge -- wiring discovery.
+ *
+ * Scans a project root for files that declare CI/CD / deploy /
+ * publish / release / mobile-distribution wiring. Each scanner is
+ * a small function that takes the project root + returns 0..N
+ * WiringHook entries.
+ *
+ * Cheap by design: every scanner short-circuits on file-missing
+ * (the overwhelming common case for any given hook kind). The
+ * outer discoverWiring() composes all of them + computes a
+ * scanned_sha so a second pass over an unchanged project takes
+ * ~5ms (only mtime reads, no file body parsing).
+ *
+ * Per Pablo (2026-06-07): semantic graph + wiring are per-project.
+ * Switch project = re-discover from scratch. Cross-project recall
+ * is intentionally NOT a feature.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+const WORKFLOW_DIR = '.github/workflows';
+const WRANGLER_TOML = 'wrangler.toml';
+const VERCEL_JSON = 'vercel.json';
+const NETLIFY_TOML = 'netlify.toml';
+const FIREBASE_JSON = 'firebase.json';
+const PACKAGE_JSON = 'package.json';
+const NPM_SCRIPT_HINTS = /^(deploy|publish|publish-|release|ship|push-prod|build-and-deploy)/i;
+/** Compose every scanner + return the merged hook list + a sha
+ *  over the mtimes of every file inspected. */
+export async function discoverWiring(opts) {
+    const inspected = [];
+    const hooks = [];
+    for (const fn of [scanGitHubActions, scanWrangler, scanVercel, scanNetlify, scanFirebase, scanNpmScripts, scanEasJsonRoots]) {
+        const r = await fn(opts);
+        inspected.push(...r.inspected);
+        hooks.push(...r.hooks);
+    }
+    const sha = await mtimeSha(inspected);
+    return { hooks, scanned_sha: sha, inspected };
+}
+async function mtimeSha(files) {
+    if (!files.length)
+        return '';
+    const stamps = [];
+    for (const f of files) {
+        try {
+            const s = await fs.stat(f);
+            stamps.push(f + ':' + s.mtimeMs.toFixed(0) + ':' + s.size.toFixed(0));
+        }
+        catch {
+            stamps.push(f + ':missing');
+        }
+    }
+    return crypto.createHash('sha256').update(stamps.join('\n')).digest('hex').slice(0, 16);
+}
+async function listIfExists(dir, suffix) {
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        const files = [];
+        for (const e of entries) {
+            if (!e.isFile())
+                continue;
+            if (suffix && !e.name.endsWith(suffix))
+                continue;
+            files.push(path.join(dir, e.name));
+        }
+        return files;
+    }
+    catch {
+        return [];
+    }
+}
+async function readIfExists(file) {
+    try {
+        return await fs.readFile(file, 'utf-8');
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+/* ----- GitHub Actions ----- */
+async function scanGitHubActions(opts) {
+    const dir = path.join(opts.project_root, WORKFLOW_DIR);
+    const files = (await listIfExists(dir, '.yml')).concat(await listIfExists(dir, '.yaml'));
+    const hooks = [];
+    for (const f of files) {
+        const raw = await readIfExists(f);
+        if (!raw)
+            continue;
+        const name = path.basename(f);
+        /* Very-light YAML parsing: we DO NOT pull a yaml dep. We care
+         * about a handful of high-signal markers (on: push|tag|schedule|
+         * workflow_dispatch + deploy/publish/release keywords + known
+         * action names). Regex is enough for this. */
+        const lower = raw.toLowerCase();
+        const trigger = inferTriggerFromGha(raw);
+        const kind = inferKindFromGha(name, raw);
+        if (!kind)
+            continue;
+        const destination = inferDestinationFromGha(raw);
+        const auto_runs_on = inferAutoRunsFromTrigger(trigger);
+        void lower;
+        hooks.push({
+            id: 'gha:' + name,
+            kind,
+            trigger,
+            destination,
+            source_file: path.relative(opts.project_root, f).replace(/\\/g, '/'),
+            auto_runs_on,
+        });
+    }
+    return { hooks, inspected: files };
+}
+function inferTriggerFromGha(yaml) {
+    /* Look at the `on:` block; first match wins. The brain matrix
+     * confirms this catches the typical handcrafted-or-templated
+     * workflows (release-please, eas-build, vercel-deploy). */
+    const onBlock = yaml.split(/\n(?=\S)/).find((b) => /^on\s*:/m.test(b)) ?? '';
+    /* Tag triggers must be checked BEFORE generic push: -- a tag push
+     * workflow has both `push:` and `tags:` keys, so order matters. */
+    if (/tags:\s*\[?\s*['"]?v\*/.test(onBlock) || /-\s*'?v\*'?/.test(onBlock))
+        return 'tag:v*';
+    if (/tags\s*:/.test(onBlock))
+        return 'tag:release-*';
+    if (/branches:\s*\[\s*main\b/.test(onBlock) || /-\s*main\b/.test(onBlock))
+        return 'push:main';
+    if (/branches:\s*\[\s*master\b/.test(onBlock) || /-\s*master\b/.test(onBlock))
+        return 'push:master';
+    if (/push\s*:/.test(onBlock))
+        return 'push:any';
+    if (/workflow_dispatch/.test(onBlock))
+        return 'manual';
+    if (/schedule\s*:/.test(onBlock))
+        return 'schedule';
+    return 'unknown';
+}
+function inferKindFromGha(name, yaml) {
+    const lower = (name + '\n' + yaml).toLowerCase();
+    if (/eas[-_ ]?(cli\s+)?(build|submit)/.test(lower) || /apps\/.*forge-mobile/.test(lower))
+        return 'mobile_distribution';
+    if (/release-please|changesets/.test(lower))
+        return 'ci_release';
+    if (/npm[\s-]?publish|publish.*npm|@nac3|registry-url/.test(lower))
+        return 'ci_publish';
+    if (/wrangler\s+(deploy|publish)/.test(lower))
+        return 'edge_deploy';
+    if (/docker[\s/-]?build|docker[\s/-]?push|buildx/.test(lower))
+        return 'docker_build';
+    if (/vercel|netlify|firebase[\s-]?deploy|cloudflare[\s-]?pages/.test(lower))
+        return 'static_hosting';
+    if (/(^|\W)deploy(\W|$)/.test(lower) || /rsync.*ssh|ssh-action|scp-action/.test(lower))
+        return 'ci_deploy';
+    return null;
+}
+function inferDestinationFromGha(yaml) {
+    const lower = yaml.toLowerCase();
+    if (/godaddy|c5kfcjz0z5se|public_html/.test(lower))
+        return 'godaddy:hosting';
+    if (/vercel/.test(lower))
+        return 'vercel:edge';
+    if (/netlify/.test(lower))
+        return 'netlify:hosting';
+    if (/cloudflare[\s/-]?pages/.test(lower))
+        return 'cloudflare:pages';
+    if (/wrangler/.test(lower))
+        return 'cloudflare:worker';
+    if (/firebase/.test(lower))
+        return 'firebase:hosting';
+    if (/registry\.npmjs\.org|npm[\s-]?publish/.test(lower))
+        return 'npm:registry';
+    if (/dockerhub|docker\.io/.test(lower))
+        return 'dockerhub:image';
+    if (/ghcr\.io/.test(lower))
+        return 'ghcr:image';
+    if (/eas[\s/-]?submit/.test(lower))
+        return 'eas:store-submit';
+    return 'unknown';
+}
+function inferAutoRunsFromTrigger(t) {
+    switch (t) {
+        case 'push:main': return ['git push origin main'];
+        case 'push:master': return ['git push origin master'];
+        case 'push:any': return ['git push'];
+        case 'tag:v*': return ['git tag v<X.Y.Z> && git push --tags'];
+        case 'tag:release-*': return ['git tag release-<X.Y.Z> && git push --tags'];
+        case 'manual': return ['gh workflow run <name.yml>'];
+        case 'schedule': return ['(cron) -- no manual trigger needed'];
+        default: return [];
+    }
+}
+/* ----- wrangler.toml (Cloudflare Worker) ----- */
+async function scanWrangler(opts) {
+    const f = path.join(opts.project_root, WRANGLER_TOML);
+    const raw = await readIfExists(f);
+    if (!raw)
+        return { hooks: [], inspected: [] };
+    const m = raw.match(/^\s*name\s*=\s*['"]([^'"]+)['"]/m);
+    const workerName = m ? m[1] : 'worker';
+    return {
+        hooks: [{
+                id: 'wrangler:' + workerName,
+                kind: 'edge_deploy',
+                trigger: 'manual',
+                destination: 'cloudflare:worker/' + workerName,
+                source_file: WRANGLER_TOML,
+                auto_runs_on: ['npx wrangler deploy', 'npx wrangler publish'],
+            }],
+        inspected: [f],
+    };
+}
+/* ----- Vercel / Netlify / Firebase ----- */
+async function scanVercel(opts) {
+    const f = path.join(opts.project_root, VERCEL_JSON);
+    const raw = await readIfExists(f);
+    if (!raw)
+        return { hooks: [], inspected: [] };
+    return {
+        hooks: [{
+                id: 'vercel:project',
+                kind: 'static_hosting',
+                trigger: 'push:any',
+                destination: 'vercel:project',
+                source_file: VERCEL_JSON,
+                auto_runs_on: ['git push (Vercel git-integration); or npx vercel --prod'],
+            }],
+        inspected: [f],
+    };
+}
+async function scanNetlify(opts) {
+    const f = path.join(opts.project_root, NETLIFY_TOML);
+    const raw = await readIfExists(f);
+    if (!raw)
+        return { hooks: [], inspected: [] };
+    return {
+        hooks: [{
+                id: 'netlify:site',
+                kind: 'static_hosting',
+                trigger: 'push:any',
+                destination: 'netlify:site',
+                source_file: NETLIFY_TOML,
+                auto_runs_on: ['git push (Netlify git-integration); or netlify deploy --prod'],
+            }],
+        inspected: [f],
+    };
+}
+async function scanFirebase(opts) {
+    const f = path.join(opts.project_root, FIREBASE_JSON);
+    const raw = await readIfExists(f);
+    if (!raw)
+        return { hooks: [], inspected: [] };
+    if (!/"hosting"/.test(raw))
+        return { hooks: [], inspected: [f] };
+    return {
+        hooks: [{
+                id: 'firebase:hosting',
+                kind: 'static_hosting',
+                trigger: 'manual',
+                destination: 'firebase:hosting',
+                source_file: FIREBASE_JSON,
+                auto_runs_on: ['firebase deploy --only hosting'],
+            }],
+        inspected: [f],
+    };
+}
+/* ----- npm scripts ----- */
+async function scanNpmScripts(opts) {
+    const f = path.join(opts.project_root, PACKAGE_JSON);
+    const raw = await readIfExists(f);
+    if (!raw)
+        return { hooks: [], inspected: [] };
+    let pkg;
+    try {
+        pkg = JSON.parse(raw);
+    }
+    catch {
+        return { hooks: [], inspected: [f] };
+    }
+    const scripts = pkg.scripts ?? {};
+    const hooks = [];
+    for (const [name, body] of Object.entries(scripts)) {
+        if (!NPM_SCRIPT_HINTS.test(name))
+            continue;
+        const kind = /publish/i.test(name) ? 'ci_publish'
+            : /release/i.test(name) ? 'ci_release'
+                : /ship|deploy|push-prod|build-and-deploy/i.test(name) ? 'ci_deploy'
+                    : 'ci_deploy';
+        hooks.push({
+            id: 'npm:scripts.' + name,
+            kind,
+            trigger: 'manual',
+            destination: inferNpmDest(body, pkg.name),
+            source_file: PACKAGE_JSON,
+            auto_runs_on: ['npm run ' + name, 'pnpm run ' + name, 'yarn ' + name],
+        });
+    }
+    return { hooks, inspected: [f] };
+}
+function inferNpmDest(body, pkgName) {
+    const lower = body.toLowerCase();
+    if (/npm publish/.test(lower))
+        return 'npm:' + (pkgName ?? 'registry');
+    if (/wrangler\s+(deploy|publish)/.test(lower))
+        return 'cloudflare:worker';
+    if (/vercel/.test(lower))
+        return 'vercel:project';
+    if (/netlify/.test(lower))
+        return 'netlify:site';
+    if (/docker\s+push/.test(lower))
+        return 'docker:registry';
+    if (/eas\s+submit/.test(lower))
+        return 'eas:store-submit';
+    if (/firebase\s+deploy/.test(lower))
+        return 'firebase:hosting';
+    if (/rsync|scp\s+/.test(lower))
+        return 'rsync:target';
+    return 'unknown';
+}
+/* ----- eas.json (mobile distribution) ----- */
+async function scanEasJsonRoots(opts) {
+    const hooks = [];
+    const inspected = [];
+    /* Two common locations: root + apps/*. We do not recurse to keep
+     * the scan cheap; this covers the standard monorepo shape. */
+    const candidates = [
+        path.join(opts.project_root, 'eas.json'),
+    ];
+    const appsDir = path.join(opts.project_root, 'apps');
+    try {
+        const apps = await fs.readdir(appsDir, { withFileTypes: true });
+        for (const a of apps) {
+            if (!a.isDirectory())
+                continue;
+            candidates.push(path.join(appsDir, a.name, 'eas.json'));
+        }
+    }
+    catch { /* no apps/ dir */ }
+    for (const f of candidates) {
+        const raw = await readIfExists(f);
+        if (!raw)
+            continue;
+        inspected.push(f);
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            continue;
+        }
+        const submit = parsed.submit ?? {};
+        const rel = path.relative(opts.project_root, f).replace(/\\/g, '/');
+        for (const profile of Object.keys(submit)) {
+            hooks.push({
+                id: 'eas:' + rel + ':submit:' + profile,
+                kind: 'mobile_distribution',
+                trigger: 'manual',
+                destination: 'eas:store-submit/' + profile,
+                source_file: rel,
+                auto_runs_on: ['npx eas-cli submit --profile ' + profile + ' --platform <android|ios>'],
+            });
+        }
+        /* If there is no submit block but there ARE build profiles, that
+         * is still useful information for the brain: builds are wired,
+         * submits are not. */
+        const build = parsed.build ?? {};
+        if (Object.keys(submit).length === 0 && Object.keys(build).length > 0) {
+            hooks.push({
+                id: 'eas:' + rel + ':build',
+                kind: 'mobile_distribution',
+                trigger: 'manual',
+                destination: 'eas:build-only',
+                source_file: rel,
+                auto_runs_on: ['npx eas-cli build --profile <name> --platform <android|ios>'],
+            });
+        }
+    }
+    return { hooks, inspected };
+}
+//# sourceMappingURL=discover.js.map

package/dist/wiring/discover.js.map

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

package/dist/wiring/store.d.ts

@@ -0,0 +1,19 @@
+import { type WiringFile, type WiringHook } from './types.js';
+/** Read the wiring file for a project. Returns an empty file when
+ *  none exists; never throws ENOENT. Other I/O errors propagate. */
+export declare function readWiring(project_slug: string): Promise<WiringFile>;
+export declare function writeWiring(file: WiringFile): Promise<void>;
+/** Replace the hooks[] of a project (discover writes this). Preserves
+ *  user annotations + disabled flags by matching incoming hooks to
+ *  existing ones via hook id. New hooks land without annotations;
+ *  hooks that vanish from the new scan get dropped entirely. */
+export declare function replaceHooks(project_slug: string, freshHooks: WiringHook[], scanned_sha: string): Promise<WiringFile>;
+export declare function annotateHook(project_slug: string, hook_id: string, patch: {
+    user_annotation?: string;
+    disabled?: boolean;
+}): Promise<WiringFile>;
+/** Drop the whole wiring file for a project (yf wiring forget). */
+export declare function forgetWiring(project_slug: string): Promise<void>;
+/** Test seam -- bust the in-process cache without touching disk. */
+export declare function _clearWiringCacheForTest(): void;
+//# sourceMappingURL=store.d.ts.map

package/dist/wiring/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/wiring/store.ts"],"names":[],"mappings":"AAsBA,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AA2BpB;oEACoE;AACpE,wBAAsB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAkC1E;AAaD,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAWjE;AAED;;;gEAGgE;AAChE,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,WAAW,EAAE,MAAM,GAClE,OAAO,CAAC,UAAU,CAAC,CA0BrB;AAED,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EACrC,KAAK,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACtD,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAED,mEAAmE;AACnE,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtE;AAED,oEAAoE;AACpE,wBAAgB,wBAAwB,IAAI,IAAI,CAAwB"}

package/dist/wiring/store.js

@@ -0,0 +1,182 @@
+/**
+ * Yujin Forge -- wiring registry store.
+ *
+ * One JSON file per project at
+ *   ~/.yujin-forge/projects/<slug>/wiring.json
+ *
+ * Mirror of the pending registry pattern. Atomic writes via
+ * `renameWithRetry` (Windows EPERM resilient). Cached for ~5s
+ * in-process so buildSystemPrompt can call readWiring() multiple
+ * times per turn without disk thrash.
+ *
+ * Lookup by hook id, by kind, by source_file. The discover module
+ * is the only writer for the hooks[] array; user annotations go
+ * through annotateHook() which preserves them across re-scans by
+ * keying on the hook id.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { renameWithRetry } from '../core/atomic_write.js';
+import { WIRING_FILE_VERSION, emptyWiringFile, } from './types.js';
+const FILE_NAME = 'wiring.json';
+const READ_CACHE_TTL_MS = 5_000;
+const READ_CACHE = new Map();
+function configRoot() {
+    if (process.env['YUJIN_FORGE_HOME'])
+        return process.env['YUJIN_FORGE_HOME'];
+    if (process.env['YF_CONFIG_DIR'])
+        return process.env['YF_CONFIG_DIR'];
+    const xdg = process.env['XDG_CONFIG_HOME'];
+    if (xdg && process.platform === 'linux')
+        return path.join(xdg, 'yujin-forge');
+    return path.join(os.homedir(), '.yujin-forge');
+}
+function projectDir(project_slug) {
+    if (!project_slug || project_slug.includes('..') || /[/\\]/.test(project_slug)) {
+        throw new Error('wiring: invalid project_slug ' + JSON.stringify(project_slug));
+    }
+    return path.join(configRoot(), 'projects', project_slug);
+}
+function fileFor(project_slug) {
+    return path.join(projectDir(project_slug), FILE_NAME);
+}
+/** Read the wiring file for a project. Returns an empty file when
+ *  none exists; never throws ENOENT. Other I/O errors propagate. */
+export async function readWiring(project_slug) {
+    const cached = READ_CACHE.get(project_slug);
+    if (cached && (Date.now() - cached.at) < READ_CACHE_TTL_MS)
+        return cached.file;
+    const f = fileFor(project_slug);
+    try {
+        const raw = await fs.readFile(f, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || parsed.version !== WIRING_FILE_VERSION
+            || !Array.isArray(parsed.hooks)) {
+            const fresh = emptyWiringFile(project_slug);
+            READ_CACHE.set(project_slug, { at: Date.now(), file: fresh });
+            return fresh;
+        }
+        const file = {
+            version: WIRING_FILE_VERSION,
+            project_slug,
+            scanned_at: typeof parsed.scanned_at === 'string' ? parsed.scanned_at : new Date(0).toISOString(),
+            scanned_sha: typeof parsed.scanned_sha === 'string' ? parsed.scanned_sha : '',
+            hooks: parsed.hooks.filter(isValidHook),
+        };
+        READ_CACHE.set(project_slug, { at: Date.now(), file });
+        return file;
+    }
+    catch (err) {
+        /* ENOENT -> empty file (no wiring yet).
+         * SyntaxError (hand-edited JSON) -> empty file too: better than
+         * a hard crash inside buildSystemPrompt at chat-server boot. */
+        const code = err instanceof Error && 'code' in err ? err.code : undefined;
+        if (code === 'ENOENT' || err instanceof SyntaxError) {
+            const fresh = emptyWiringFile(project_slug);
+            READ_CACHE.set(project_slug, { at: Date.now(), file: fresh });
+            return fresh;
+        }
+        throw err;
+    }
+}
+function isValidHook(h) {
+    if (!h || typeof h !== 'object')
+        return false;
+    const o = h;
+    return typeof o['id'] === 'string'
+        && typeof o['kind'] === 'string'
+        && typeof o['trigger'] === 'string'
+        && typeof o['destination'] === 'string'
+        && typeof o['source_file'] === 'string'
+        && Array.isArray(o['auto_runs_on']);
+}
+export async function writeWiring(file) {
+    if (file.version !== WIRING_FILE_VERSION) {
+        throw new Error('wiring: writeWiring rejected -- version mismatch');
+    }
+    const dir = projectDir(file.project_slug);
+    await fs.mkdir(dir, { recursive: true });
+    const f = fileFor(file.project_slug);
+    const tmp = f + '.tmp';
+    await fs.writeFile(tmp, JSON.stringify(file, null, 2) + '\n', 'utf-8');
+    await renameWithRetry(tmp, f);
+    READ_CACHE.set(file.project_slug, { at: Date.now(), file });
+}
+/** Replace the hooks[] of a project (discover writes this). Preserves
+ *  user annotations + disabled flags by matching incoming hooks to
+ *  existing ones via hook id. New hooks land without annotations;
+ *  hooks that vanish from the new scan get dropped entirely. */
+export async function replaceHooks(project_slug, freshHooks, scanned_sha) {
+    const current = await readWiring(project_slug);
+    const annotationsById = new Map();
+    for (const h of current.hooks) {
+        const e = {};
+        if (h.user_annotation !== undefined)
+            e.annotation = h.user_annotation;
+        if (h.disabled !== undefined)
+            e.disabled = h.disabled;
+        if (Object.keys(e).length > 0)
+            annotationsById.set(h.id, e);
+    }
+    const merged = freshHooks.map((h) => {
+        const ann = annotationsById.get(h.id);
+        if (!ann)
+            return h;
+        const out = { ...h };
+        if (ann.annotation !== undefined)
+            out.user_annotation = ann.annotation;
+        if (ann.disabled !== undefined)
+            out.disabled = ann.disabled;
+        return out;
+    });
+    const next = {
+        version: WIRING_FILE_VERSION,
+        project_slug,
+        scanned_at: new Date().toISOString(),
+        scanned_sha,
+        hooks: merged,
+    };
+    await writeWiring(next);
+    return next;
+}
+export async function annotateHook(project_slug, hook_id, patch) {
+    const file = await readWiring(project_slug);
+    const idx = file.hooks.findIndex((h) => h.id === hook_id);
+    if (idx === -1)
+        throw new Error('wiring: hook not found: ' + hook_id);
+    const updated = { ...file.hooks[idx] };
+    if (patch.user_annotation !== undefined) {
+        if (patch.user_annotation === '')
+            delete updated.user_annotation;
+        else
+            updated.user_annotation = patch.user_annotation;
+    }
+    if (patch.disabled !== undefined) {
+        if (patch.disabled === false)
+            delete updated.disabled;
+        else
+            updated.disabled = true;
+    }
+    file.hooks[idx] = updated;
+    await writeWiring(file);
+    return file;
+}
+/** Drop the whole wiring file for a project (yf wiring forget). */
+export async function forgetWiring(project_slug) {
+    const f = fileFor(project_slug);
+    try {
+        await fs.unlink(f);
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT')
+            return;
+        throw err;
+    }
+    READ_CACHE.delete(project_slug);
+}
+/** Test seam -- bust the in-process cache without touching disk. */
+export function _clearWiringCacheForTest() { READ_CACHE.clear(); }
+//# sourceMappingURL=store.js.map

package/dist/wiring/store.js.map

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