@dezycro-ai/agent-plugin 2.0.0

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

@@ -0,0 +1,118 @@
+/**
+ * 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.
+ */
+export declare const STATES: Readonly<{
+    readonly IDLE: "IDLE";
+    readonly DETECT_INTENT: "DETECT_INTENT";
+    readonly SCAN_EXISTING_WORK: "SCAN_EXISTING_WORK";
+    readonly CLARIFY: "CLARIFY";
+    readonly PROPOSE_PLACEMENT: "PROPOSE_PLACEMENT";
+    readonly CREATE_FEATURE: "CREATE_FEATURE";
+    readonly TRD_DISCOVERY: "TRD_DISCOVERY";
+    readonly MIN_CONTEXT_GATE: "MIN_CONTEXT_GATE";
+    readonly DRAFT: "DRAFT";
+    readonly ITERATE: "ITERATE";
+    readonly QUALITY_GATE: "QUALITY_GATE";
+    readonly FINALIZE: "FINALIZE";
+}>;
+export type AuthoringStateName = typeof STATES[keyof typeof STATES];
+export declare const DOC_TYPES: Readonly<{
+    readonly PRD: "PRD";
+    readonly TRD: "TRD";
+}>;
+export type DocType = typeof DOC_TYPES[keyof typeof DOC_TYPES];
+export declare const SKIP_PHRASES: readonly string[];
+export declare const NON_SKIPPABLE_STATES: readonly AuthoringStateName[];
+export declare const TRANSCRIPT_FILENAME = "authoring-transcript.json";
+export declare const DRAFT_SIDECAR_FILENAME = "authoring-current-draft.json";
+export interface AuthoringTranscript {
+    docId: string;
+    docType: DocType;
+    featureId: string | null;
+    seed: string | null;
+    startedTs: string;
+    discoverySummary: string | null;
+    qaTurns: Array<{
+        ts: string;
+        question: string;
+        answer: string;
+        category: string | null;
+    }>;
+    draftHistory: Array<{
+        ts: string;
+        contentHash: string;
+    }>;
+    qualityGateHistory: Array<{
+        ts: string;
+        passed: boolean;
+        blockingIssues: unknown[];
+        score: number | null;
+        deterministic: boolean;
+    }>;
+}
+export interface DraftSidecar {
+    docId: string;
+    docType: DocType;
+    content: string;
+    prdDocId: string | null;
+    prdContent: string | null;
+    updatedTs: string;
+}
+declare function transcriptPath(repoRoot: string): string;
+declare function draftSidecarPath(repoRoot: string): string;
+export interface EnterOpts {
+    docId: string;
+    docType: DocType;
+    featureId?: string | null;
+    seed?: string | null;
+}
+export declare function enter(repoRoot: string, opts: EnterOpts): AuthoringTranscript;
+export declare function exit(repoRoot: string): void;
+export declare function isActive(repoRoot: string): boolean;
+export interface AuthoringStateSnapshot {
+    active: boolean;
+    docId: string | null;
+    docType: DocType | null;
+    transcriptPath: string | null;
+    startedTs: string | null;
+}
+export declare function getState(repoRoot: string): AuthoringStateSnapshot;
+export interface RecordAnswerOpts {
+    question: string;
+    answer: string;
+    category?: string | null;
+}
+export declare function recordAnswer(repoRoot: string, opts: RecordAnswerOpts): AuthoringTranscript | null;
+export declare function recordDiscoverySummary(repoRoot: string, discoverySummary: string | null): AuthoringTranscript | null;
+export declare function recordDraft(repoRoot: string, opts: {
+    contentHash: string;
+}): AuthoringTranscript | null;
+export interface RecordGateResultOpts {
+    passed: boolean;
+    blockingIssues?: unknown[];
+    score?: number;
+    deterministic?: boolean;
+}
+export declare function recordGateResult(repoRoot: string, opts: RecordGateResultOpts): AuthoringTranscript | null;
+export declare function readTranscript(repoRoot: string): AuthoringTranscript | null;
+export interface WriteDraftSidecarOpts {
+    docId: string;
+    docType: DocType;
+    content: string;
+    prdDocId?: string | null;
+    prdContent?: string | null;
+}
+export declare function writeDraftSidecar(repoRoot: string, opts: WriteDraftSidecarOpts): void;
+export declare function readDraftSidecar(repoRoot: string): DraftSidecar | null;
+export declare function isSkipPhrase(userMessage: unknown): boolean;
+export declare function isNonSkippableState(stateName: AuthoringStateName): boolean;
+export declare const _transcriptPath: typeof transcriptPath;
+export declare const _draftSidecarPath: typeof draftSidecarPath;
+export {};

package/dist/hooks/lib/authoring.js

@@ -0,0 +1,277 @@
+/**
+ * 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/config.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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;

package/dist/hooks/lib/config.js

@@ -0,0 +1,175 @@
+/**
+ * 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.
+ */
+'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._deepMerge = exports.DEFAULT_CONFIG = exports.PRESETS = void 0;
+exports.deepMerge = deepMerge;
+exports.load = load;
+exports.resolveThresholds = resolveThresholds;
+exports.findRepoRoot = findRepoRoot;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+exports.PRESETS = Object.freeze({
+    conservative: { decision: 0.85, issue: 0.80, assumption: 0.90, taskStatus: 0.90 },
+    balanced: { decision: 0.75, issue: 0.70, assumption: 0.80, taskStatus: 0.85 },
+    aggressive: { decision: 0.60, issue: 0.55, assumption: 0.70, taskStatus: 0.75 },
+});
+exports.DEFAULT_CONFIG = Object.freeze({
+    companion: {
+        autoVerify: {
+            preTaskDone: true,
+            prePush: true,
+            postEditPulse: { enabled: true, threshold: 5 },
+            autoPublishSpecOnControllerChange: true,
+            controllerPaths: [
+                '**/controllers/**/*.{kt,java,py,go,ts,tsx,js,rs,rb,cs}',
+                '**/api/**/*.{kt,java,py,go,ts,tsx,js,rs,rb,cs}',
+            ],
+            verifyTimeoutSeconds: 300,
+            publishSpecTimeoutSeconds: 300,
+        },
+        autoWorkbookUpdates: {
+            enabled: true,
+            preset: 'conservative',
+            maxAutoLogsPerTurn: 2,
+            maxAutoLogsPerSession: 10,
+            undoWindow: 'next-turn',
+            thresholds: {
+                decision: null,
+                issue: null,
+                assumption: null,
+                taskStatus: null,
+            },
+            trivialTurnCharCutoff: 600,
+            hashRingBufferSize: 32,
+        },
+        coverageNudges: {
+            enabled: true,
+            staleBaselineDays: 14,
+            fetchMode: 'async',
+        },
+        authoring: {
+            defaultDepth: 'adaptive',
+            existingWorkScan: true,
+            qualityGate: { enabled: true },
+            minViableContextGate: { enabled: true },
+        },
+        safeMode: false,
+    },
+});
+function isPlainObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+function deepMerge(base, override) {
+    if (!isPlainObject(override))
+        return override === undefined ? base : override;
+    const baseObj = (Array.isArray(base) ? [...base] : { ...base });
+    for (const key of Object.keys(override)) {
+        const b = baseObj[key];
+        const o = override[key];
+        if (isPlainObject(b) && isPlainObject(o)) {
+            baseObj[key] = deepMerge(b, o);
+        }
+        else {
+            baseObj[key] = o;
+        }
+    }
+    return baseObj;
+}
+/**
+ * Load `.dezycro/config.json` from the given repo root, deep-merged with
+ * DEFAULT_CONFIG. Returns DEFAULT_CONFIG if the file is missing or unparseable.
+ */
+function load(repoRoot) {
+    const file = path.join(repoRoot, '.dezycro', 'config.json');
+    let raw;
+    try {
+        raw = fs.readFileSync(file, 'utf8');
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === 'ENOENT')
+            return JSON.parse(JSON.stringify(exports.DEFAULT_CONFIG));
+        throw err;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return JSON.parse(JSON.stringify(exports.DEFAULT_CONFIG));
+    }
+    return deepMerge(JSON.parse(JSON.stringify(exports.DEFAULT_CONFIG)), parsed);
+}
+/**
+ * Resolve per-type confidence thresholds for the workbook sweep, honoring
+ * `companion.autoWorkbookUpdates.preset` and any numeric overrides under
+ * `companion.autoWorkbookUpdates.thresholds.*`.
+ */
+function resolveThresholds(config) {
+    const ws = config?.companion?.autoWorkbookUpdates || {};
+    const presetName = (ws.preset || 'conservative');
+    const base = exports.PRESETS[presetName] || exports.PRESETS.conservative;
+    const overrides = ws.thresholds || {};
+    return {
+        decision: typeof overrides.decision === 'number' ? overrides.decision : base.decision,
+        issue: typeof overrides.issue === 'number' ? overrides.issue : base.issue,
+        assumption: typeof overrides.assumption === 'number' ? overrides.assumption : base.assumption,
+        taskStatus: typeof overrides.taskStatus === 'number' ? overrides.taskStatus : base.taskStatus,
+    };
+}
+/**
+ * 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.
+ */
+function findRepoRoot(startDir) {
+    let dir = path.resolve(startDir || process.cwd());
+    for (let i = 0; i < 64; i += 1) {
+        if (fs.existsSync(path.join(dir, '.dezycro')))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+    return null;
+}
+exports._deepMerge = deepMerge;

package/dist/hooks/lib/controller-match.d.ts

@@ -0,0 +1,16 @@
+/**
+ * controller-match.ts — match file paths against `controllerPaths` globs from
+ * `.dezycro/config.json` (TRD §5.2).
+ *
+ * Minimal glob subset (stdlib only):
+ *   - `**`   zero or more path segments
+ *   - `*`    any chars within a single segment (no slashes)
+ *   - `?`    any single char within a single segment
+ *   - `{a,b}` alternation (`*.{kt,java}`)
+ *
+ * Limitations: no character classes, no escaping, forward-slash only.
+ */
+export declare function expandAlternation(glob: string): string[];
+export declare function globToRegex(glob: string): RegExp;
+export declare function matchesControllerPath(filePath: string, globs: string[]): boolean;
+export declare function selectControllers(filePaths: string[], globs: string[]): string[];