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

package/README.md

@@ -7,7 +7,22 @@ loop: read design specs by voice, generate code scaffolds from
 those specs, decorate vanilla HTML into NAC-3, drive existing apps
 via voice + chat.
 
-> Status: **v0.2.0-alpha (HITO 0 + HITO 1 closed)**, 2026-05-23.
+> Status: **v0.2.0-alpha.59z.92** (2026-06-04). **100% manifest
+> verb coverage**: every one of the 72 declared NAC-3 verbs has
+> at least one fake-scripted scenario asserting it gets invoked
+> (or refuses to) in the right intent. Brain matrix QA harness
+> at 168 scenarios (+68 since z.61); 22 new verbs in the arc
+> (8 misc + git.status/branch-list + office.excel.append-sheet
+> + 12 others); 8 helper CLIs under `yf qa` (run, scenarios
+> list/show/validate/stats, verbs coverage/sample,
+> brain-matrix-compare); 5 ops docs (SECURITY, CONTRIBUTING,
+> TESTING_GUIDE, DEPLOYMENT, CI_PIPELINE); 2 new doctrines
+> (verb-composition, explain-results); 2 new invariant kinds
+> (min_text_length, verb_invoked_in_order) + structural
+> fixture validator + lefthook pre-commit gate. F101 MCP
+> bridge backend complete (slice 3 panel UI pending); F106
+> office.* + F107 a11y.* verbs shipped; HITO 5 agent
+> orchestrator design draft awaiting Pablo clarification.
 >
 > **HITO 0 -- credentials vault.** AES-256-GCM at-rest encryption
 > with machine fingerprint binding, atomic writes (0o600), one-shot

package/dist/a11y/helpers.d.ts

@@ -0,0 +1,88 @@
+/**
+ * F107 accessibility helpers -- screen-reader + voice-first hooks
+ * for adopter apps generated by Forge.
+ *
+ * These are pure helpers (no DOM dependency at this layer) that the
+ * panel + mobile adapters consume. They translate semantic intents
+ * ("announce this", "focus that element", "describe this element")
+ * into payloads the rendering layer can route to:
+ *   - ARIA live regions for screen readers
+ *   - Voice TTS for the Forge voice loop
+ *   - Mobile screen-reader bridges (VoiceOver / TalkBack)
+ *
+ * The verbs operate on NAC-3 element slugs (declared via
+ * data-nac-* attrs in the adopter app) so the brain never has to
+ * know about raw DOM identifiers.
+ *
+ * ASCII-only.
+ */
+export type Politeness = 'polite' | 'assertive';
+export interface AnnounceRequest {
+    /** Text to announce. */
+    text: string;
+    /** ARIA live-region politeness. Default 'polite'. */
+    politeness?: Politeness;
+    /** When set, also speak via TTS (voice loop). Default false. */
+    speak?: boolean;
+    /** Locale hint (BCP47). Default inherits the user's voice config. */
+    locale?: string;
+}
+export interface AnnouncePayload {
+    type: 'aria-live';
+    text: string;
+    politeness: Politeness;
+    /** Set when the runtime should also speak the text. */
+    speak: boolean;
+    locale: string | null;
+}
+export interface FocusRequest {
+    /** NAC-3 element slug (the value of data-nac-slug). */
+    slug: string;
+    /** When set, scrolls the element into view. Default true. */
+    scroll?: boolean;
+    /** Announce the focus change via screen reader. Default true. */
+    announce?: boolean;
+}
+export interface FocusPayload {
+    type: 'focus';
+    slug: string;
+    scroll: boolean;
+    announce: boolean;
+}
+export interface LabelRequest {
+    /** NAC-3 element slug. */
+    slug: string;
+    /** Human-readable description (will become aria-label /
+     *  aria-describedby depending on field). */
+    description: string;
+    /** Optional shortcut hint (e.g. 'Ctrl+S'). */
+    shortcut?: string;
+    /** Optional role hint (e.g. 'button', 'textbox'). */
+    role?: string;
+}
+export interface LabelPayload {
+    type: 'label';
+    slug: string;
+    /** Sanitised description -- max 500 chars, single line. */
+    description: string;
+    shortcut: string | null;
+    role: string | null;
+}
+export declare function buildAnnouncePayload(req: AnnounceRequest): AnnouncePayload | {
+    ok: false;
+    error: string;
+};
+export declare function buildFocusPayload(req: FocusRequest): FocusPayload | {
+    ok: false;
+    error: string;
+};
+export declare function buildLabelPayload(req: LabelRequest): LabelPayload | {
+    ok: false;
+    error: string;
+};
+/** NAC-3 data-nac-* attr -> ARIA attribute mapping. Used by the
+ *  panel renderer + mobile adapter to project the semantic layer
+ *  onto the native a11y tree. */
+export declare const NAC3_TO_ARIA: Record<string, string>;
+export declare function mapNac3ToAria(attrs: Record<string, string>): Record<string, string>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/a11y/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/a11y/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,uDAAuD;IACvD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb;gDAC4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAOD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,eAAe,GAAG,eAAe,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAiBzG;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAchG;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAmBhG;AAED;;iCAEiC;AACjC,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAU/C,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOnF"}

package/dist/a11y/helpers.js

@@ -0,0 +1,109 @@
+/**
+ * F107 accessibility helpers -- screen-reader + voice-first hooks
+ * for adopter apps generated by Forge.
+ *
+ * These are pure helpers (no DOM dependency at this layer) that the
+ * panel + mobile adapters consume. They translate semantic intents
+ * ("announce this", "focus that element", "describe this element")
+ * into payloads the rendering layer can route to:
+ *   - ARIA live regions for screen readers
+ *   - Voice TTS for the Forge voice loop
+ *   - Mobile screen-reader bridges (VoiceOver / TalkBack)
+ *
+ * The verbs operate on NAC-3 element slugs (declared via
+ * data-nac-* attrs in the adopter app) so the brain never has to
+ * know about raw DOM identifiers.
+ *
+ * ASCII-only.
+ */
+const MAX_TEXT = 1000;
+const MAX_DESCRIPTION = 500;
+const MAX_SLUG = 120;
+const SLUG_RE = /^[a-z0-9][a-z0-9._-]*$/i;
+export function buildAnnouncePayload(req) {
+    if (typeof req.text !== 'string') {
+        return { ok: false, error: 'text must be a string' };
+    }
+    const t = req.text.trim();
+    if (!t)
+        return { ok: false, error: 'text is empty' };
+    if (t.length > MAX_TEXT) {
+        return { ok: false, error: 'text exceeds ' + MAX_TEXT + ' chars' };
+    }
+    const politeness = req.politeness === 'assertive' ? 'assertive' : 'polite';
+    return {
+        type: 'aria-live',
+        text: t,
+        politeness,
+        speak: req.speak === true,
+        locale: typeof req.locale === 'string' && req.locale ? req.locale : null,
+    };
+}
+export function buildFocusPayload(req) {
+    if (typeof req.slug !== 'string') {
+        return { ok: false, error: 'slug must be a string' };
+    }
+    const s = req.slug.trim();
+    if (!s)
+        return { ok: false, error: 'slug is empty' };
+    if (s.length > MAX_SLUG)
+        return { ok: false, error: 'slug too long' };
+    if (!SLUG_RE.test(s))
+        return { ok: false, error: 'slug must match [a-z0-9._-]' };
+    return {
+        type: 'focus',
+        slug: s,
+        scroll: req.scroll !== false,
+        announce: req.announce !== false,
+    };
+}
+export function buildLabelPayload(req) {
+    if (typeof req.slug !== 'string')
+        return { ok: false, error: 'slug must be a string' };
+    const s = req.slug.trim();
+    if (!s)
+        return { ok: false, error: 'slug is empty' };
+    if (s.length > MAX_SLUG)
+        return { ok: false, error: 'slug too long' };
+    if (!SLUG_RE.test(s))
+        return { ok: false, error: 'slug must match [a-z0-9._-]' };
+    if (typeof req.description !== 'string')
+        return { ok: false, error: 'description must be a string' };
+    const d = req.description.replace(/\s+/g, ' ').trim();
+    if (!d)
+        return { ok: false, error: 'description is empty' };
+    if (d.length > MAX_DESCRIPTION) {
+        return { ok: false, error: 'description exceeds ' + MAX_DESCRIPTION + ' chars' };
+    }
+    return {
+        type: 'label',
+        slug: s,
+        description: d,
+        shortcut: typeof req.shortcut === 'string' && req.shortcut ? req.shortcut : null,
+        role: typeof req.role === 'string' && req.role ? req.role : null,
+    };
+}
+/** NAC-3 data-nac-* attr -> ARIA attribute mapping. Used by the
+ *  panel renderer + mobile adapter to project the semantic layer
+ *  onto the native a11y tree. */
+export const NAC3_TO_ARIA = {
+    'data-nac-slug': 'data-yujin-slug',
+    'data-nac-role': 'role',
+    'data-nac-label': 'aria-label',
+    'data-nac-desc': 'aria-describedby',
+    'data-nac-busy': 'aria-busy',
+    'data-nac-pressed': 'aria-pressed',
+    'data-nac-checked': 'aria-checked',
+    'data-nac-hidden': 'aria-hidden',
+    'data-nac-live': 'aria-live',
+};
+export function mapNac3ToAria(attrs) {
+    const out = {};
+    for (const [k, v] of Object.entries(attrs)) {
+        const target = NAC3_TO_ARIA[k];
+        if (target)
+            out[target] = v;
+    }
+    return out;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/a11y/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/a11y/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA6DH,MAAM,QAAQ,GAAY,IAAI,CAAC;AAC/B,MAAM,eAAe,GAAK,GAAG,CAAC;AAC9B,MAAM,QAAQ,GAAY,GAAG,CAAC;AAC9B,MAAM,OAAO,GAAa,yBAAyB,CAAC;AAEpD,MAAM,UAAU,oBAAoB,CAAC,GAAoB;IACvD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACvD,CAAC;IACD,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IACrD,IAAI,CAAC,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,GAAG,QAAQ,GAAG,QAAQ,EAAE,CAAC;IACrE,CAAC;IACD,MAAM,UAAU,GAAe,GAAG,CAAC,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;IACvF,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,CAAC;QACP,UAAU;QACV,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK,IAAI;QACzB,MAAM,EAAE,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;KACzE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAiB;IACjD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACvD,CAAC;IACD,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IACrD,IAAI,CAAC,CAAC,MAAM,GAAG,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IACtE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC;IACjF,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,CAAC;QACP,MAAM,EAAI,GAAG,CAAC,MAAM,KAAO,KAAK;QAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ,KAAK,KAAK;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAiB;IACjD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACvF,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IACrD,IAAI,CAAC,CAAC,MAAM,GAAG,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IACtE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC;IACjF,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC;IACrG,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAC5D,IAAI,CAAC,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QAC/B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,GAAG,eAAe,GAAG,QAAQ,EAAE,CAAC;IACnF,CAAC;IACD,OAAO;QACL,IAAI,EAAS,OAAO;QACpB,IAAI,EAAS,CAAC;QACd,WAAW,EAAE,CAAC;QACd,QAAQ,EAAK,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;QACnF,IAAI,EAAS,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;KACxE,CAAC;AACJ,CAAC;AAED;;iCAEiC;AACjC,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,eAAe,EAAK,iBAAiB;IACrC,eAAe,EAAK,MAAM;IAC1B,gBAAgB,EAAI,YAAY;IAChC,eAAe,EAAK,kBAAkB;IACtC,eAAe,EAAK,WAAW;IAC/B,kBAAkB,EAAE,cAAc;IAClC,kBAAkB,EAAE,cAAc;IAClC,iBAAiB,EAAG,aAAa;IACjC,eAAe,EAAK,WAAW;CAChC,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,KAA6B;IACzD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,MAAM;YAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/agents/bridge.d.ts

@@ -0,0 +1,69 @@
+import { type AgentMessage, type AgentPairCap } from './types.js';
+export interface BridgeOpts {
+    /** Override ~/.yujin-forge for tests. */
+    root?: string;
+    /** Override clock for deterministic tests. */
+    now?: () => number;
+    /** Slice 1 of N-projects sprint -- bridge sharding. When set,
+     *  reads/writes `bridge/bridge-{project_slug}.json` instead of
+     *  the global `bridge/bridge.json`. Defaults to 'self' so the
+     *  legacy filename (bridge.json) is preserved byte-for-byte
+     *  whenever no project is specified. */
+    project_slug?: string;
+}
+/** List every shard file present under <root>/bridge. Returns
+ *  pairs {project_slug, file}. Used by Activity / scan endpoints
+ *  to read across all projects without knowing the slug list. */
+export declare function listBridgeShards(opts?: BridgeOpts): Promise<Array<{
+    project_slug: string;
+    file: string;
+}>>;
+export type BridgeErrorCode = 'invalid_slug' | 'sender_not_found' | 'receiver_not_found' | 'acl_denied' | 'token_cap_reached' | 'pair_frozen' | 'pair_auto_revoked';
+export declare class BridgeError extends Error {
+    code: BridgeErrorCode;
+    constructor(code: BridgeErrorCode, message: string);
+}
+export interface SendMessageInput {
+    from_slug: string;
+    to_slug: string;
+    payload: unknown;
+    /** Tokens to charge against the pair cap. Caller estimates +
+     *  the bridge subtracts before persisting. */
+    tokens_used: number;
+    /** Slice 1 N-projects sprint -- which project this message
+     *  belongs to. Defaults to 'self' (legacy single-project mode).
+     *  Drives shard file selection + persists on the message row
+     *  for downstream filtering. */
+    project_slug?: string;
+}
+export interface SendMessageResult {
+    message: AgentMessage;
+    pair_state: AgentPairCap;
+}
+/** Send a message from one agent to another. Runs ACL +
+ *  pair-cap + loop-detector checks. Throws BridgeError when a
+ *  gate trips. The caller -- usually agents/runner.ts during a
+ *  run -- catches and surfaces a graceful failure to the brain. */
+export declare function sendMessage(input: SendMessageInput, opts?: BridgeOpts): Promise<SendMessageResult>;
+export interface DrainResult {
+    drained: AgentMessage[];
+    expired_skipped: number;
+}
+/** Pull pending messages for the given agent. Caps the batch at
+ *  agent.bridge.inbox_drain_batch. Marks every returned message
+ *  delivered_at = now. Expired messages are skipped + counted. */
+export declare function drainInbox(slug: string, opts?: BridgeOpts): Promise<DrainResult>;
+/** Mark a delivered message as read (the receiver processed it). */
+export declare function markRead(messageId: number, opts?: BridgeOpts): Promise<boolean>;
+/** Inspect pair-level state (cap window + loop detector + status). */
+export declare function pairState(a: string, b: string, opts?: BridgeOpts): Promise<AgentPairCap | null>;
+/** Manually re-enable a pair that was auto-revoked. Resets the
+ *  loop counter + token window so the next send starts clean.
+ *  Returns false when the pair has no state yet. */
+export declare function reEnablePair(a: string, b: string, opts?: BridgeOpts): Promise<boolean>;
+/** List ALL messages (debug / panel "audit" view). */
+export declare function listAllMessages(opts?: BridgeOpts): Promise<AgentMessage[]>;
+/** Test helper: wipe the bridge file. NOT exported in package
+ *  index -- only tests import from this file directly. */
+export declare function _resetBridgeForTests(opts?: BridgeOpts): Promise<void>;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/agents/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/agents/bridge.ts"],"names":[],"mappings":"AAqBA,OAAO,EAEL,KAAK,YAAY,EAA2B,KAAK,YAAY,EAC9D,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB;;;;4CAIwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA+BD;;iEAEiE;AACjE,wBAAsB,gBAAgB,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAehH;AAmBD,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,kBAAkB,GAClB,oBAAoB,GACpB,YAAY,GACZ,mBAAmB,GACnB,aAAa,GACb,mBAAmB,CAAC;AAExB,qBAAa,WAAY,SAAQ,KAAK;IACjB,IAAI,EAAE,eAAe;gBAArB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAI1D;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB;kDAC8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB;;;oCAGgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,YAAY,CAAC;CAC1B;AAED;;;mEAGmE;AACnE,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,UAAU,GACzC,OAAO,CAAC,iBAAiB,CAAC,CA6H5B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;kEAEkE;AAClE,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAC9B,OAAO,CAAC,WAAW,CAAC,CA0BtB;AAED,oEAAoE;AACpE,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GACnC,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,sEAAsE;AACtE,wBAAsB,SAAS,CAC7B,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GACtC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAI9B;AAED;;oDAEoD;AACpD,wBAAsB,YAAY,CAChC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GACtC,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED,sDAAsD;AACtD,wBAAsB,eAAe,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAGhF;AAED;0DAC0D;AAC1D,wBAAsB,oBAAoB,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3E"}

package/dist/agents/bridge.js

@@ -0,0 +1,295 @@
+/**
+ * Inter-agent bridge (Director sprint slice 2).
+ *
+ * Local-only persistence per D3 decision (see
+ * docs/DIRECTOR_DECISIONS_2026_06_04.md): a single JSON file at
+ * `~/.yujin-forge/bridge/bridge.json` holds the message log +
+ * pair-level cap state. SQLite was specced originally but JSON
+ * has zero native-dep cost (no better-sqlite3 compile per arch)
+ * and is plenty for a single-process Node runtime.
+ *
+ * Read-modify-write is atomic via tmp+rename. Single-process,
+ * no concurrent writers expected (`yf chat` is one process).
+ *
+ * Every cap / window / TTL is read from getAgentConfig(...).
+ * Zero hardcoded numbers per the D2 lock.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { pairIdFor, isValidAgentSlug, } from './types.js';
+import { getAgentConfig } from './config_resolver.js';
+import { getAgentDefinition } from './store.js';
+const EMPTY_BRIDGE = {
+    version: 1,
+    next_message_id: 1,
+    messages: [],
+    pair_state: {},
+};
+function defaultRoot() {
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    return path.join(home, '.yujin-forge');
+}
+function bridgeFile(opts) {
+    const root = opts?.root ?? defaultRoot();
+    /* Sharding by project_slug. 'self' (default) maps to the legacy
+     * filename so existing deployments + tests keep working byte-for-
+     * byte; explicit projects shard into bridge-{slug}.json. */
+    const project = opts?.project_slug || 'self';
+    const filename = project === 'self' ? 'bridge.json' : 'bridge-' + project + '.json';
+    return path.join(root, 'bridge', filename);
+}
+/** List every shard file present under <root>/bridge. Returns
+ *  pairs {project_slug, file}. Used by Activity / scan endpoints
+ *  to read across all projects without knowing the slug list. */
+export async function listBridgeShards(opts) {
+    const root = opts?.root ?? defaultRoot();
+    const dir = path.join(root, 'bridge');
+    const out = [];
+    try {
+        const names = await fs.readdir(dir);
+        for (const n of names) {
+            if (n === 'bridge.json')
+                out.push({ project_slug: 'self', file: path.join(dir, n) });
+            else if (n.startsWith('bridge-') && n.endsWith('.json')) {
+                const slug = n.slice('bridge-'.length, n.length - '.json'.length);
+                if (slug)
+                    out.push({ project_slug: slug, file: path.join(dir, n) });
+            }
+        }
+    }
+    catch { /* dir absent -- ok, no shards */ }
+    return out;
+}
+async function readBridge(opts) {
+    try {
+        const raw = await fs.readFile(bridgeFile(opts), 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed && parsed.version === 1)
+            return parsed;
+    }
+    catch { /* missing or malformed -- start fresh */ }
+    return { ...EMPTY_BRIDGE, messages: [], pair_state: {} };
+}
+async function writeBridge(b, opts) {
+    const file = bridgeFile(opts);
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    const tmp = file + '.tmp';
+    await fs.writeFile(tmp, JSON.stringify(b, null, 2), 'utf-8');
+    await fs.rename(tmp, file);
+}
+export class BridgeError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'BridgeError';
+    }
+}
+/** Send a message from one agent to another. Runs ACL +
+ *  pair-cap + loop-detector checks. Throws BridgeError when a
+ *  gate trips. The caller -- usually agents/runner.ts during a
+ *  run -- catches and surfaces a graceful failure to the brain. */
+export async function sendMessage(input, opts) {
+    const now = (opts?.now ?? Date.now)();
+    /* Caller may pass project_slug on the input OR opts; the input
+     * wins for the message row (it's what the agent declared) and
+     * the opts is what selects the shard file. We unify them so a
+     * caller can pass it once on either side. */
+    const effectiveProject = input.project_slug || opts?.project_slug || 'self';
+    const bridgeOpts = { ...opts, project_slug: effectiveProject };
+    if (!isValidAgentSlug(input.from_slug)) {
+        throw new BridgeError('invalid_slug', 'from_slug is not a valid agent slug');
+    }
+    if (!isValidAgentSlug(input.to_slug)) {
+        throw new BridgeError('invalid_slug', 'to_slug is not a valid agent slug');
+    }
+    if (input.from_slug === input.to_slug) {
+        throw new BridgeError('acl_denied', 'an agent cannot message itself');
+    }
+    const root = opts?.root;
+    const fromDef = await getAgentDefinition(input.from_slug, root ? { root } : undefined);
+    if (!fromDef) {
+        throw new BridgeError('sender_not_found', 'from_slug "' + input.from_slug + '" not registered');
+    }
+    const toDef = await getAgentDefinition(input.to_slug, root ? { root } : undefined);
+    if (!toDef) {
+        throw new BridgeError('receiver_not_found', 'to_slug "' + input.to_slug + '" not registered');
+    }
+    /* Two-sided ACL handshake:
+     *   from.can_call must include to (or '*')
+     *   to.can_be_called_by must include from (or '*') */
+    const fromAllowsTo = fromDef.can_call.includes('*') ||
+        fromDef.can_call.includes(input.to_slug);
+    const toAcceptsFrom = toDef.can_be_called_by.includes('*') ||
+        toDef.can_be_called_by.includes(input.from_slug);
+    if (!fromAllowsTo || !toAcceptsFrom) {
+        throw new BridgeError('acl_denied', 'ACL: ' + input.from_slug + ' -> ' + input.to_slug + ' is not whitelisted on both ends');
+    }
+    /* Pair cap + loop detector. */
+    const pairId = pairIdFor(input.from_slug, input.to_slug);
+    const b = await readBridge(bridgeOpts);
+    const tokenCap = await getAgentConfig('agent.bridge.tokens_per_pair_hourly');
+    const rtWindowSeconds = await getAgentConfig('agent.bridge.round_trips_window_seconds');
+    const rtMax = await getAgentConfig('agent.bridge.round_trips_max');
+    const ttlSeconds = await getAgentConfig('agent.bridge.message_ttl_seconds');
+    const existing = b.pair_state[pairId];
+    /* Reset rolling 1h cap window when expired. */
+    const windowMs = 60 * 60 * 1000;
+    const rtWindowMs = rtWindowSeconds * 1000;
+    const fresh = existing
+        ? { ...existing }
+        : {
+            pair_id: pairId,
+            tokens_used_window: 0,
+            window_started_at: now,
+            round_trips_60s: 0,
+            last_round_trip_at: 0,
+            status: 'open',
+        };
+    if (fresh.status === 'auto_revoked') {
+        throw new BridgeError('pair_auto_revoked', 'pair ' + pairId + ' auto-revoked; manual re-enable required');
+    }
+    if (now - fresh.window_started_at > windowMs) {
+        fresh.tokens_used_window = 0;
+        fresh.window_started_at = now;
+        fresh.status = 'open';
+    }
+    if (fresh.tokens_used_window + input.tokens_used > tokenCap) {
+        fresh.status = 'frozen';
+        b.pair_state[pairId] = fresh;
+        await writeBridge(b, bridgeOpts);
+        throw new BridgeError('token_cap_reached', 'pair ' + pairId + ' hit token cap (' + tokenCap + ') in current 1h window');
+    }
+    /* Round-trip loop check: a round trip is from->to followed by
+     * to->from inside the window. We count direction flips by
+     * peeking at the most recent message on this pair. */
+    const lastOnPair = [...b.messages].reverse().find((m) => m.pair_id === pairId);
+    if (lastOnPair && lastOnPair.to_slug === input.from_slug) {
+        /* A reply to the previous message = one round trip. */
+        if (now - fresh.last_round_trip_at <= rtWindowMs) {
+            fresh.round_trips_60s += 1;
+        }
+        else {
+            fresh.round_trips_60s = 1;
+        }
+        fresh.last_round_trip_at = now;
+        if (fresh.round_trips_60s >= rtMax) {
+            fresh.status = 'auto_revoked';
+            b.pair_state[pairId] = fresh;
+            await writeBridge(b, bridgeOpts);
+            throw new BridgeError('pair_auto_revoked', 'pair ' + pairId + ' tripped loop detector ('
+                + fresh.round_trips_60s + ' round trips in '
+                + rtWindowSeconds + 's window). Auto-revoked.');
+        }
+    }
+    /* All checks passed. Append the message + update pair state. */
+    fresh.tokens_used_window += input.tokens_used;
+    const msg = {
+        id: b.next_message_id,
+        pair_id: pairId,
+        from_slug: input.from_slug,
+        to_slug: input.to_slug,
+        payload: input.payload,
+        tokens_used: input.tokens_used,
+        status: 'pending',
+        created_at: now,
+        expires_at: now + ttlSeconds * 1000,
+        project_slug: effectiveProject,
+    };
+    b.next_message_id += 1;
+    b.messages.push(msg);
+    b.pair_state[pairId] = fresh;
+    await writeBridge(b, bridgeOpts);
+    return { message: msg, pair_state: fresh };
+}
+/** Pull pending messages for the given agent. Caps the batch at
+ *  agent.bridge.inbox_drain_batch. Marks every returned message
+ *  delivered_at = now. Expired messages are skipped + counted. */
+export async function drainInbox(slug, opts) {
+    if (!isValidAgentSlug(slug)) {
+        throw new BridgeError('invalid_slug', 'invalid slug');
+    }
+    const now = (opts?.now ?? Date.now)();
+    const batchLimit = await getAgentConfig('agent.bridge.inbox_drain_batch');
+    const b = await readBridge(opts);
+    const drained = [];
+    let expired_skipped = 0;
+    for (const m of b.messages) {
+        if (m.to_slug !== slug)
+            continue;
+        if (m.status !== 'pending')
+            continue;
+        if (m.expires_at <= now) {
+            m.status = 'expired';
+            expired_skipped += 1;
+            continue;
+        }
+        if (drained.length >= batchLimit)
+            break;
+        m.status = 'delivered';
+        m.delivered_at = now;
+        drained.push(m);
+    }
+    if (drained.length > 0 || expired_skipped > 0) {
+        await writeBridge(b, opts);
+    }
+    return { drained, expired_skipped };
+}
+/** Mark a delivered message as read (the receiver processed it). */
+export async function markRead(messageId, opts) {
+    const now = (opts?.now ?? Date.now)();
+    const b = await readBridge(opts);
+    const m = b.messages.find((x) => x.id === messageId);
+    if (!m)
+        return false;
+    if (m.status !== 'delivered' && m.status !== 'pending')
+        return false;
+    m.status = 'read';
+    m.read_at = now;
+    await writeBridge(b, opts);
+    return true;
+}
+/** Inspect pair-level state (cap window + loop detector + status). */
+export async function pairState(a, b, opts) {
+    const pid = pairIdFor(a, b);
+    const file = await readBridge(opts);
+    return file.pair_state[pid] ?? null;
+}
+/** Manually re-enable a pair that was auto-revoked. Resets the
+ *  loop counter + token window so the next send starts clean.
+ *  Returns false when the pair has no state yet. */
+export async function reEnablePair(a, b, opts) {
+    const pid = pairIdFor(a, b);
+    const now = (opts?.now ?? Date.now)();
+    const file = await readBridge(opts);
+    const existing = file.pair_state[pid];
+    if (!existing)
+        return false;
+    file.pair_state[pid] = {
+        pair_id: pid,
+        tokens_used_window: 0,
+        window_started_at: now,
+        round_trips_60s: 0,
+        last_round_trip_at: 0,
+        status: 'open',
+    };
+    await writeBridge(file, opts);
+    return true;
+}
+/** List ALL messages (debug / panel "audit" view). */
+export async function listAllMessages(opts) {
+    const b = await readBridge(opts);
+    return b.messages.slice();
+}
+/** Test helper: wipe the bridge file. NOT exported in package
+ *  index -- only tests import from this file directly. */
+export async function _resetBridgeForTests(opts) {
+    try {
+        await fs.rm(bridgeFile(opts), { force: true });
+    }
+    catch { /* ignore */ }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/agents/bridge.js.map

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

package/dist/agents/cli_real.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `yf agent run --real` helper (Director closure pendiente 1).
+ *
+ * Resolves the production wiring (Claude client + runtime +
+ * factory) so the CLI subcommand stays thin + tests can inject
+ * fakes for any of them.
+ *
+ * ASCII-only.
+ */
+import type { AgentDefinition } from './types.js';
+import type { StepFn } from './runner.js';
+import type { Runtime } from './runtime.js';
+import { ClaudeClient } from '../chat/claude.js';
+interface MakeRealStepOpts {
+    def: AgentDefinition;
+    trigger_reason: string;
+    project_root: string;
+    project_name: string;
+    forge_version: string;
+    /** Inject a different Claude client (tests). When unset, the
+     *  real ClaudeClient is constructed from the vault. */
+    claude?: ConstructorParameters<typeof ClaudeClient>[0] extends infer P ? P extends void | undefined ? import('../chat/claude.js').ClaudeClient : import('../chat/claude.js').ClaudeClient : import('../chat/claude.js').ClaudeClient;
+    runtime?: Runtime;
+    /** Where the bridge persists. Tests pass tmp; production lets
+     *  it resolve to ~/.yujin-forge/bridge. */
+    bridge_root?: string;
+}
+export interface CliRealError extends Error {
+    code: 'no_claude_key' | 'unknown';
+}
+/**
+ * Build the live StepFn the runner will execute. Returns the
+ * StepFn directly; the caller (the CLI subcommand) wraps it with
+ * `runAgent(def, {step, ...})`.
+ */
+export declare function makeRealStep(opts: MakeRealStepOpts): Promise<StepFn>;
+export {};
+//# sourceMappingURL=cli_real.d.ts.map