@dezycro-ai/agent-plugin 2.1.2 → 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,66 +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++, and
- *   `lastAttemptTs` advances so the floor throttles repeated failures. Once
- *   failures cross `circuitBreakerThreshold` the floor grows exponentially
- *   (capped at `maxBackoffSeconds`), so an unreachable endpoint is not polled on
- *   every hook fire. A single success resets the counter and the interval.
- *
- * 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;
-    circuitBreakerThreshold: number;
-    maxBackoffSeconds: number;
-}
-/**
- * Effective poll interval given the number of consecutive failures so far.
- * Returns the base interval until `threshold` failures, then doubles per extra
- * failure, capped at `maxSeconds`. Never throws.
- */
-export declare function backoffSeconds(baseSeconds: number, consecutiveFailures: number, threshold: number, maxSeconds: number): number;
-/**
- * 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;
-    backoffSeconds: typeof backoffSeconds;
-};
-export {};