@dezycro-ai/agent-plugin 2.1.1 → 2.2.0

package/dist/hooks/lib/authoring.js

@@ -1,277 +0,0 @@
-/**
- * authoring.ts — state machine helpers for /dezycro:author (TRD §5.5.1).
- *
- * The skill markdown drives the agent turn-by-turn; this module owns the
- * persisted side effects (authoring mode in companion-state.json, the
- * transcript at .dezycro/authoring-transcript.json, and the most-recent-draft
- * sidecar at .dezycro/authoring-current-draft.json).
- *
- * No LLM calls live here.
- */
-'use strict';
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports._draftSidecarPath = exports._transcriptPath = exports.DRAFT_SIDECAR_FILENAME = exports.TRANSCRIPT_FILENAME = exports.NON_SKIPPABLE_STATES = exports.SKIP_PHRASES = exports.DOC_TYPES = exports.STATES = void 0;
-exports.enter = enter;
-exports.exit = exit;
-exports.isActive = isActive;
-exports.getState = getState;
-exports.recordAnswer = recordAnswer;
-exports.recordDiscoverySummary = recordDiscoverySummary;
-exports.recordDraft = recordDraft;
-exports.recordGateResult = recordGateResult;
-exports.readTranscript = readTranscript;
-exports.writeDraftSidecar = writeDraftSidecar;
-exports.readDraftSidecar = readDraftSidecar;
-exports.isSkipPhrase = isSkipPhrase;
-exports.isNonSkippableState = isNonSkippableState;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const state = __importStar(require("./state"));
-exports.STATES = Object.freeze({
-    IDLE: 'IDLE',
-    DETECT_INTENT: 'DETECT_INTENT',
-    SCAN_EXISTING_WORK: 'SCAN_EXISTING_WORK',
-    CLARIFY: 'CLARIFY',
-    PROPOSE_PLACEMENT: 'PROPOSE_PLACEMENT',
-    CREATE_FEATURE: 'CREATE_FEATURE',
-    TRD_DISCOVERY: 'TRD_DISCOVERY',
-    MIN_CONTEXT_GATE: 'MIN_CONTEXT_GATE',
-    DRAFT: 'DRAFT',
-    ITERATE: 'ITERATE',
-    QUALITY_GATE: 'QUALITY_GATE',
-    FINALIZE: 'FINALIZE',
-});
-exports.DOC_TYPES = Object.freeze({ PRD: 'PRD', TRD: 'TRD' });
-exports.SKIP_PHRASES = Object.freeze(['skip', 'draft it', 'just write it', 'next']);
-exports.NON_SKIPPABLE_STATES = Object.freeze([
-    exports.STATES.MIN_CONTEXT_GATE,
-    exports.STATES.QUALITY_GATE,
-]);
-exports.TRANSCRIPT_FILENAME = 'authoring-transcript.json';
-exports.DRAFT_SIDECAR_FILENAME = 'authoring-current-draft.json';
-function transcriptPath(repoRoot) {
-    return path.join(repoRoot, '.dezycro', exports.TRANSCRIPT_FILENAME);
-}
-function draftSidecarPath(repoRoot) {
-    return path.join(repoRoot, '.dezycro', exports.DRAFT_SIDECAR_FILENAME);
-}
-function ensureDezycroDir(repoRoot) {
-    fs.mkdirSync(path.join(repoRoot, '.dezycro'), { recursive: true });
-}
-function writeJsonAtomic(filePath, data) {
-    const tmp = `${filePath}.tmp`;
-    const fd = fs.openSync(tmp, 'w');
-    try {
-        fs.writeSync(fd, JSON.stringify(data, null, 2));
-        fs.fsyncSync(fd);
-    }
-    finally {
-        fs.closeSync(fd);
-    }
-    fs.renameSync(tmp, filePath);
-}
-function readJson(filePath) {
-    try {
-        const raw = fs.readFileSync(filePath, 'utf8');
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}
-function enter(repoRoot, opts) {
-    if (!opts || !opts.docId || !opts.docType) {
-        throw new Error('authoring.enter: docId and docType required');
-    }
-    if (opts.docType !== exports.DOC_TYPES.PRD && opts.docType !== exports.DOC_TYPES.TRD) {
-        throw new Error(`authoring.enter: invalid docType ${opts.docType}`);
-    }
-    ensureDezycroDir(repoRoot);
-    const tp = transcriptPath(repoRoot);
-    const now = new Date().toISOString();
-    const existing = readJson(tp);
-    const transcript = existing && existing.docId === opts.docId
-        ? existing
-        : {
-            docId: opts.docId,
-            docType: opts.docType,
-            featureId: opts.featureId || null,
-            seed: opts.seed || null,
-            startedTs: now,
-            discoverySummary: null,
-            qaTurns: [],
-            draftHistory: [],
-            qualityGateHistory: [],
-        };
-    writeJsonAtomic(tp, transcript);
-    state.patch(repoRoot, {
-        authoringMode: true,
-        authoringDocId: opts.docId,
-        authoringDocType: opts.docType,
-        authoringTranscriptPath: tp,
-        authoringStartedTs: now,
-    });
-    return transcript;
-}
-function exit(repoRoot) {
-    state.patch(repoRoot, {
-        authoringMode: false,
-        authoringDocId: null,
-        authoringDocType: null,
-        authoringTranscriptPath: null,
-        authoringStartedTs: null,
-    });
-    for (const p of [transcriptPath(repoRoot), draftSidecarPath(repoRoot)]) {
-        try {
-            fs.unlinkSync(p);
-        }
-        catch { /* ignore */ }
-    }
-}
-function isActive(repoRoot) {
-    const s = state.read(repoRoot);
-    return Boolean(s && s.authoringMode);
-}
-function getState(repoRoot) {
-    const s = state.read(repoRoot);
-    return {
-        active: Boolean(s && s.authoringMode),
-        docId: s ? s.authoringDocId : null,
-        docType: s ? s.authoringDocType : null,
-        transcriptPath: s ? s.authoringTranscriptPath : null,
-        startedTs: s ? s.authoringStartedTs : null,
-    };
-}
-function recordAnswer(repoRoot, opts) {
-    if (!opts || typeof opts.question !== 'string' || typeof opts.answer !== 'string') {
-        throw new Error('authoring.recordAnswer: question and answer required');
-    }
-    const tp = transcriptPath(repoRoot);
-    const t = readJson(tp);
-    if (!t)
-        return null;
-    t.qaTurns = (t.qaTurns || []).concat([{
-            ts: new Date().toISOString(),
-            question: opts.question,
-            answer: opts.answer,
-            category: opts.category || null,
-        }]);
-    writeJsonAtomic(tp, t);
-    return t;
-}
-function recordDiscoverySummary(repoRoot, discoverySummary) {
-    const tp = transcriptPath(repoRoot);
-    const t = readJson(tp);
-    if (!t)
-        return null;
-    t.discoverySummary = discoverySummary || null;
-    writeJsonAtomic(tp, t);
-    return t;
-}
-function recordDraft(repoRoot, opts) {
-    if (!opts || typeof opts.contentHash !== 'string') {
-        throw new Error('authoring.recordDraft: contentHash required');
-    }
-    const tp = transcriptPath(repoRoot);
-    const t = readJson(tp);
-    if (!t)
-        return null;
-    t.draftHistory = (t.draftHistory || []).concat([{
-            ts: new Date().toISOString(),
-            contentHash: opts.contentHash,
-        }]);
-    writeJsonAtomic(tp, t);
-    return t;
-}
-function recordGateResult(repoRoot, opts) {
-    if (!opts || typeof opts.passed !== 'boolean') {
-        throw new Error('authoring.recordGateResult: passed required');
-    }
-    const tp = transcriptPath(repoRoot);
-    const t = readJson(tp);
-    if (!t)
-        return null;
-    t.qualityGateHistory = (t.qualityGateHistory || []).concat([{
-            ts: new Date().toISOString(),
-            passed: opts.passed,
-            blockingIssues: opts.blockingIssues || [],
-            score: typeof opts.score === 'number' ? opts.score : null,
-            deterministic: opts.deterministic === true,
-        }]);
-    writeJsonAtomic(tp, t);
-    return t;
-}
-function readTranscript(repoRoot) {
-    return readJson(transcriptPath(repoRoot));
-}
-function writeDraftSidecar(repoRoot, opts) {
-    if (!opts || !opts.docId || !opts.docType || typeof opts.content !== 'string') {
-        throw new Error('authoring.writeDraftSidecar: docId, docType, content required');
-    }
-    ensureDezycroDir(repoRoot);
-    writeJsonAtomic(draftSidecarPath(repoRoot), {
-        docId: opts.docId,
-        docType: opts.docType,
-        content: opts.content,
-        prdDocId: opts.prdDocId || null,
-        prdContent: opts.prdContent || null,
-        updatedTs: new Date().toISOString(),
-    });
-}
-function readDraftSidecar(repoRoot) {
-    return readJson(draftSidecarPath(repoRoot));
-}
-function isSkipPhrase(userMessage) {
-    if (typeof userMessage !== 'string')
-        return false;
-    const trimmed = userMessage.trim().toLowerCase();
-    if (!trimmed)
-        return false;
-    const stripped = trimmed.replace(/[.!?,;:]+$/g, '').trim();
-    for (const phrase of exports.SKIP_PHRASES) {
-        if (stripped === phrase)
-            return true;
-        if (stripped.startsWith(`${phrase} `) || stripped.startsWith(`${phrase},`))
-            return true;
-    }
-    return false;
-}
-function isNonSkippableState(stateName) {
-    return exports.NON_SKIPPABLE_STATES.includes(stateName);
-}
-// Path helpers exposed for tests and the router.
-exports._transcriptPath = transcriptPath;
-exports._draftSidecarPath = draftSidecarPath;

package/dist/hooks/lib/command-bus.d.ts

@@ -1,53 +0,0 @@
-/**
- * command-bus.ts — pulls the Agent Command Bus inbox on hook boundaries and renders
- * unseen events for the agent transcript.
- *
- * Polling model (per the Agent Command Bus TRD):
- * * `session-start` always polls (no floor).
- * * `user-prompt-submit`, `stop`, `post-tool-use` poll only if `minPollIntervalSeconds`
- *   has elapsed since the last successful poll.
- * * On 2xx: advance cursor + lastPollTs, dedup by `eventId` (recent ring, cap 200),
- *   return new events for surfacing.
- * * On non-2xx / network failure: cursor stays put, consecutiveFailures++.
- *
- * Auth: a bearer token from `.dezycro/companion-token.local.json` (`{"token": "dzy_…"}`)
- * is sent on every request. Separate from the MCP server token (the user maintains both).
- *
- * URL: `<environments[default].apiUrl>/api/v1/workspaces/<wsId>/features/<fId>/inbox`.
- * Active feature comes from `.dezycro/active-feature.json` written by `/dezycro:work`.
- */
-import type { CommandBusConfig, CommandBusHook, CommandBusReactionMode, CompanionState, InboxEvent, StatePatch } from '../types';
-export interface PollResult {
-    events: InboxEvent[];
-    statePatch: StatePatch | null;
-    reactionMode: CommandBusReactionMode;
-}
-interface ResolvedConfig {
-    enabled: boolean;
-    hooks: ReadonlySet<CommandBusHook>;
-    minPollIntervalSeconds: number;
-    reactionMode: CommandBusReactionMode;
-}
-/**
- * Entry point called from each hook handler. Returns the events that should be surfaced
- * to the agent on this hook fire, plus a state patch the caller must apply.
- *
- * Never throws — failures are logged and result in `{events: [], statePatch: null}`.
- */
-export declare function pollIfDue(repoRoot: string, hookEvent: CommandBusHook, config: CommandBusConfig | undefined, state: CompanionState): Promise<PollResult>;
-/**
- * Render zero or more events as a chat-ready Markdown block. Returns the empty string
- * when there is nothing to surface — callers can guard with the return value's length.
- */
-export declare function renderForAgent(events: InboxEvent[], reactionMode: CommandBusReactionMode): string;
-declare function renderEvent(e: InboxEvent): string;
-declare function reactionGuidance(mode: CommandBusReactionMode): string;
-declare function resolveConfig(c: CommandBusConfig | undefined): ResolvedConfig;
-declare function trimRecent(ids: string[]): string[];
-export declare const _internals: {
-    resolveConfig: typeof resolveConfig;
-    renderEvent: typeof renderEvent;
-    reactionGuidance: typeof reactionGuidance;
-    trimRecent: typeof trimRecent;
-};
-export {};

package/dist/hooks/lib/command-bus.js

@@ -1,318 +0,0 @@
-/**
- * command-bus.ts — pulls the Agent Command Bus inbox on hook boundaries and renders
- * unseen events for the agent transcript.
- *
- * Polling model (per the Agent Command Bus TRD):
- * * `session-start` always polls (no floor).
- * * `user-prompt-submit`, `stop`, `post-tool-use` poll only if `minPollIntervalSeconds`
- *   has elapsed since the last successful poll.
- * * On 2xx: advance cursor + lastPollTs, dedup by `eventId` (recent ring, cap 200),
- *   return new events for surfacing.
- * * On non-2xx / network failure: cursor stays put, consecutiveFailures++.
- *
- * Auth: a bearer token from `.dezycro/companion-token.local.json` (`{"token": "dzy_…"}`)
- * is sent on every request. Separate from the MCP server token (the user maintains both).
- *
- * URL: `<environments[default].apiUrl>/api/v1/workspaces/<wsId>/features/<fId>/inbox`.
- * Active feature comes from `.dezycro/active-feature.json` written by `/dezycro:work`.
- */
-'use strict';
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports._internals = void 0;
-exports.pollIfDue = pollIfDue;
-exports.renderForAgent = renderForAgent;
-const fs = __importStar(require("fs"));
-const os = __importStar(require("os"));
-const path = __importStar(require("path"));
-const logging = __importStar(require("./logging"));
-const DEFAULT_HOOKS = [
-    'sessionStart',
-    'userPromptSubmit',
-    'stop',
-    'postToolUse',
-];
-const DEFAULT_MIN_POLL_INTERVAL_SECONDS = 60;
-const DEFAULT_REACTION_MODE = 'HALT_AND_REPLAN';
-const RECENT_EVENT_IDS_CAP = 200;
-const POLL_LIMIT = 100;
-/**
- * Entry point called from each hook handler. Returns the events that should be surfaced
- * to the agent on this hook fire, plus a state patch the caller must apply.
- *
- * Never throws — failures are logged and result in `{events: [], statePatch: null}`.
- */
-async function pollIfDue(repoRoot, hookEvent, config, state) {
-    const resolved = resolveConfig(config);
-    const reactionMode = resolved.reactionMode;
-    const empty = { events: [], statePatch: null, reactionMode };
-    if (!resolved.enabled)
-        return empty;
-    if (!resolved.hooks.has(hookEvent) && hookEvent !== 'sessionStart')
-        return empty;
-    // SessionStart always polls regardless of the configured hook set — bootstrap-on-start
-    // is non-negotiable for cursor recovery after compaction.
-    const cbState = state.commandBus;
-    if (hookEvent !== 'sessionStart' && cbState.lastPollTs) {
-        const lastMs = Date.parse(cbState.lastPollTs);
-        if (!Number.isNaN(lastMs)) {
-            const ageSeconds = (Date.now() - lastMs) / 1000;
-            if (ageSeconds < resolved.minPollIntervalSeconds)
-                return empty;
-        }
-    }
-    const feature = readActiveFeature(repoRoot);
-    if (!feature)
-        return empty;
-    const apiUrl = readApiUrl(repoRoot);
-    if (!apiUrl)
-        return empty;
-    const token = readToken(repoRoot);
-    if (!token) {
-        logging.info(repoRoot, 'command_bus_skip_no_token', { hookEvent });
-        return empty;
-    }
-    const since = hookEvent === 'sessionStart' ? null : cbState.cursor;
-    try {
-        const fetched = await fetchInbox(apiUrl, feature, token, since);
-        const seen = new Set(cbState.recentEventIds ?? []);
-        const fresh = fetched.events.filter((e) => !seen.has(e.eventId));
-        const newRing = trimRecent([...(cbState.recentEventIds ?? []), ...fresh.map((e) => e.eventId)]);
-        const patch = {
-            commandBus: {
-                cursor: fetched.nextCursor || cbState.cursor,
-                lastPollTs: fetched.serverTs,
-                consecutiveFailures: 0,
-                recentEventIds: newRing,
-            },
-        };
-        if (fresh.length > 0) {
-            logging.info(repoRoot, 'command_bus_events_received', {
-                hookEvent,
-                count: fresh.length,
-                types: fresh.map((e) => e.eventType),
-            });
-        }
-        return { events: fresh, statePatch: patch, reactionMode };
-    }
-    catch (e) {
-        const patch = {
-            commandBus: {
-                ...cbState,
-                consecutiveFailures: (cbState.consecutiveFailures ?? 0) + 1,
-            },
-        };
-        logging.info(repoRoot, 'command_bus_poll_failed', {
-            hookEvent,
-            error: e instanceof Error ? e.message : String(e),
-            consecutiveFailures: patch.commandBus.consecutiveFailures,
-        });
-        return { events: [], statePatch: patch, reactionMode };
-    }
-}
-/**
- * Render zero or more events as a chat-ready Markdown block. Returns the empty string
- * when there is nothing to surface — callers can guard with the return value's length.
- */
-function renderForAgent(events, reactionMode) {
-    if (events.length === 0)
-        return '';
-    const lines = [];
-    lines.push(`⚠️ Dezycro Command Bus: ${events.length} new event(s) on this feature.`);
-    lines.push('');
-    for (const e of events) {
-        lines.push(renderEvent(e));
-    }
-    if (events.some((e) => e.urgency === 'BLOCKING')) {
-        lines.push('');
-        lines.push(reactionGuidance(reactionMode));
-    }
-    return lines.join('\n');
-}
-function renderEvent(e) {
-    if (e.eventType === 'INVALIDATION') {
-        const summary = stringField(e.payload, 'artifactSummary') ?? '(no summary)';
-        const reason = stringField(e.payload, 'reason') ?? '(no reason)';
-        const prev = stringField(e.payload, 'previousStatus') ?? '?';
-        const sourceLabel = `${e.sourceType.toLowerCase()} ${e.sourceId ?? '?'}`;
-        return `- INVALIDATION (${e.urgency}): ${sourceLabel} ("${truncate(summary, 120)}") — reason: "${truncate(reason, 200)}" — was ${prev}.`;
-    }
-    return `- ${e.eventType} (${e.urgency}) source=${e.sourceType}/${e.sourceId ?? '-'}.`;
-}
-function reactionGuidance(mode) {
-    switch (mode) {
-        case 'HALT_AND_REPLAN':
-            return 'Reaction mode: HALT_AND_REPLAN — pause your current line of work, acknowledge in chat, and re-plan around these invalidations before touching code again.';
-        case 'ACKNOWLEDGE_AND_CONTINUE':
-            return 'Reaction mode: ACKNOWLEDGE_AND_CONTINUE — surface this in your reply but continue current work; do not silently reuse invalidated artifacts.';
-        case 'SILENT_LOG':
-            return 'Reaction mode: SILENT_LOG — recorded for the session transcript; no chat interruption.';
-        default:
-            return '';
-    }
-}
-/* ─── Helpers ─────────────────────────────────────────────────────────── */
-function resolveConfig(c) {
-    const enabled = c?.enabled !== false; // default true
-    const hooks = new Set(c?.pollHooks ?? DEFAULT_HOOKS);
-    hooks.add('sessionStart'); // bootstrap is non-removable
-    const minPollIntervalSeconds = Math.max(0, c?.minPollIntervalSeconds ?? DEFAULT_MIN_POLL_INTERVAL_SECONDS);
-    const reactionMode = c?.reactionMode ?? DEFAULT_REACTION_MODE;
-    return { enabled, hooks, minPollIntervalSeconds, reactionMode };
-}
-function readActiveFeature(repoRoot) {
-    try {
-        const p = path.join(repoRoot, '.dezycro', 'active-feature.json');
-        if (!fs.existsSync(p))
-            return null;
-        const raw = JSON.parse(fs.readFileSync(p, 'utf8'));
-        const featureId = typeof raw.featureId === 'string' ? raw.featureId : null;
-        const workspaceId = typeof raw.workspaceId === 'string' ? raw.workspaceId : null;
-        if (!featureId)
-            return null;
-        if (workspaceId)
-            return { workspaceId, featureId };
-        // Older active-feature.json shapes only carry featureId; fall back to config.
-        const wsFromConfig = readWorkspaceId(repoRoot);
-        if (!wsFromConfig)
-            return null;
-        return { workspaceId: wsFromConfig, featureId };
-    }
-    catch {
-        return null;
-    }
-}
-function readApiUrl(repoRoot) {
-    const cfg = readDezycroConfig(repoRoot);
-    if (!cfg)
-        return null;
-    const environments = Array.isArray(cfg.environments) ? cfg.environments : [];
-    const defaultEnv = environments.find((e) => e && e.default === true) ?? environments[0];
-    if (!defaultEnv)
-        return null;
-    const apiUrl = defaultEnv.apiUrl;
-    return typeof apiUrl === 'string' && apiUrl.length > 0 ? apiUrl.replace(/\/$/, '') : null;
-}
-function readWorkspaceId(repoRoot) {
-    const cfg = readDezycroConfig(repoRoot);
-    if (!cfg)
-        return null;
-    const wsId = cfg.workspaceId;
-    return typeof wsId === 'string' ? wsId : null;
-}
-function readDezycroConfig(repoRoot) {
-    try {
-        const p = path.join(repoRoot, '.dezycro', 'config.json');
-        if (!fs.existsSync(p))
-            return null;
-        return JSON.parse(fs.readFileSync(p, 'utf8'));
-    }
-    catch {
-        return null;
-    }
-}
-function readToken(repoRoot) {
-    // Project-local override first, then the user-global token written by
-    // `dezycro-setup` (`~/.dezycro/token.json`). Typical install needs no
-    // per-repo file at all.
-    const candidates = [
-        path.join(repoRoot, '.dezycro', 'companion-token.local.json'),
-        path.join(os.homedir(), '.dezycro', 'token.json'),
-    ];
-    for (const p of candidates) {
-        try {
-            if (!fs.existsSync(p))
-                continue;
-            const raw = JSON.parse(fs.readFileSync(p, 'utf8'));
-            const token = raw.token;
-            if (typeof token === 'string' && token.length > 0)
-                return token;
-        }
-        catch {
-            // Try the next candidate.
-        }
-    }
-    return null;
-}
-async function fetchInbox(apiUrl, feature, token, since) {
-    const url = new URL(`${apiUrl}/api/v1/workspaces/${feature.workspaceId}/features/${feature.featureId}/inbox`);
-    if (since)
-        url.searchParams.set('since', since);
-    url.searchParams.set('limit', String(POLL_LIMIT));
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), 5000);
-    try {
-        const res = await fetch(url.toString(), {
-            method: 'GET',
-            headers: {
-                Authorization: `Bearer ${token}`,
-                Accept: 'application/json',
-            },
-            signal: controller.signal,
-        });
-        if (!res.ok) {
-            throw new Error(`inbox poll returned ${res.status}`);
-        }
-        const body = (await res.json());
-        if (!body || typeof body.serverTs !== 'string' || typeof body.nextCursor !== 'string') {
-            throw new Error('inbox poll response missing serverTs/nextCursor');
-        }
-        return {
-            serverTs: body.serverTs,
-            nextCursor: body.nextCursor,
-            events: Array.isArray(body.events) ? body.events : [],
-        };
-    }
-    finally {
-        clearTimeout(timeoutId);
-    }
-}
-function trimRecent(ids) {
-    return ids.length <= RECENT_EVENT_IDS_CAP ? ids : ids.slice(ids.length - RECENT_EVENT_IDS_CAP);
-}
-function stringField(payload, key) {
-    const v = payload?.[key];
-    return typeof v === 'string' ? v : null;
-}
-function truncate(s, max) {
-    return s.length <= max ? s : s.slice(0, max - 1) + '…';
-}
-/* Exported for tests. */
-exports._internals = {
-    resolveConfig,
-    renderEvent,
-    reactionGuidance,
-    trimRecent,
-};

package/dist/hooks/lib/config.d.ts

@@ -1,28 +0,0 @@
-/**
- * config.ts — reads `.dezycro/config.json` and resolves Companion settings.
- *
- * Owns the named-preset constant table (TRD §7.2) for the workbook sweep
- * confidence-threshold logic.
- */
-import type { CompanionConfig, PresetName, Thresholds } from '../types';
-export declare const PRESETS: Readonly<Record<PresetName, Thresholds>>;
-export declare const DEFAULT_CONFIG: Readonly<CompanionConfig>;
-export declare function deepMerge<T>(base: T, override: unknown): T;
-/**
- * Load `.dezycro/config.json` from the given repo root, deep-merged with
- * DEFAULT_CONFIG. Returns DEFAULT_CONFIG if the file is missing or unparseable.
- */
-export declare function load(repoRoot: string): CompanionConfig;
-/**
- * Resolve per-type confidence thresholds for the workbook sweep, honoring
- * `companion.autoWorkbookUpdates.preset` and any numeric overrides under
- * `companion.autoWorkbookUpdates.thresholds.*`.
- */
-export declare function resolveThresholds(config: CompanionConfig): Thresholds;
-/**
- * Find the nearest ancestor of `startDir` that contains a `.dezycro/`
- * directory, returning that ancestor as the repo root. Returns null if not
- * found before reaching the filesystem root.
- */
-export declare function findRepoRoot(startDir: string | null | undefined): string | null;
-export declare const _deepMerge: typeof deepMerge;