@protoboxai/codeloop 0.3.0

package/dist/lib/competitors.d.ts

@@ -0,0 +1,28 @@
+/** One wiki page per competitor: docs and changelog links in the front matter, findings added below by each research stage. */
+export declare const COMPETITORS_DIR = ".codeloop/wiki/competitors";
+export interface Competitor {
+    /** The file name without `.md`. */
+    name: string;
+    path: string;
+    title: string;
+    docs?: string;
+    changelog?: string;
+    body: string;
+}
+export declare function listCompetitors(projectDir: string): Competitor[];
+/** Adding a name that already has a page updates its links and keeps its findings. */
+export declare function addCompetitor(projectDir: string, input: {
+    name: string;
+    title?: string;
+    docs?: string;
+    changelog?: string;
+}): Competitor;
+/**
+ * Copies each competitor's rows from a card's research onto that competitor's page, so findings
+ * build up across features. A page that already has rows from the card is left alone.
+ * Returns the pages that were changed.
+ */
+export declare function appendFindings(projectDir: string, card: {
+    id: string;
+    title: string;
+}, research: string): string[];

package/dist/lib/competitors.js

@@ -0,0 +1,90 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { stringify } from 'yaml';
+import { RefusalError, safeName } from './cards.js';
+import { CLOUD_COPY, writeCloudWikiPage } from './cloud.js';
+import { withLock } from './lock.js';
+import { parseFrontmatter } from './skills.js';
+/** One wiki page per competitor: docs and changelog links in the front matter, findings added below by each research stage. */
+export const COMPETITORS_DIR = '.codeloop/wiki/competitors';
+const pagePath = (name) => `${COMPETITORS_DIR}/${safeName(name, 'competitor name').toLowerCase()}.md`;
+function render(c) {
+    const frontmatter = { title: c.title, ...(c.docs ? { docs: c.docs } : {}), ...(c.changelog ? { changelog: c.changelog } : {}) };
+    return `---\n${stringify(frontmatter)}---\n\n${c.body.trim()}\n`;
+}
+export function listCompetitors(projectDir) {
+    const dir = join(projectDir, COMPETITORS_DIR);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir).filter(f => f.endsWith('.md') && !f.endsWith(CLOUD_COPY)).sort().map(file => {
+        const { data, body } = parseFrontmatter(readFileSync(join(dir, file), 'utf-8'));
+        const name = file.replace(/\.md$/, '');
+        return {
+            name,
+            path: `${COMPETITORS_DIR}/${file}`,
+            title: String(data.title ?? name),
+            ...(data.docs ? { docs: String(data.docs) } : {}),
+            ...(data.changelog ? { changelog: String(data.changelog) } : {}),
+            body: body.trim(),
+        };
+    });
+}
+/** Adding a name that already has a page updates its links and keeps its findings. */
+export function addCompetitor(projectDir, input) {
+    const path = pagePath(input.name);
+    for (const url of [input.docs, input.changelog]) {
+        if (url && !/^https?:\/\//.test(url))
+            throw new RefusalError(`"${url}" is not an http(s) URL`);
+    }
+    return withLock(join(projectDir, path), () => {
+        const existing = listCompetitors(projectDir).find(c => c.path === path);
+        const page = {
+            name: path.replace(/^.*\//, '').replace(/\.md$/, ''),
+            path,
+            title: input.title ?? existing?.title ?? input.name,
+            docs: input.docs ?? existing?.docs,
+            changelog: input.changelog ?? existing?.changelog,
+            body: existing?.body ?? '## Findings',
+        };
+        mkdirSync(dirname(join(projectDir, path)), { recursive: true });
+        writeFileSync(join(projectDir, path), render(page));
+        writeCloudWikiPage(projectDir, path);
+        return page;
+    });
+}
+// A findings row is a table row or a list item in research.md whose first cell or label is a competitor's name.
+function rowFor(line, competitor) {
+    const names = [competitor.name.toLowerCase(), competitor.title.toLowerCase()];
+    const table = /^\|\s*([^|]+?)\s*\|(.+)$/.exec(line.trim());
+    if (table && names.includes(table[1].toLowerCase()))
+        return table[2].replace(/\|\s*$/, '').split('|').map(c => c.trim()).join(' | ');
+    const item = /^[-*]\s+\**([^:*]+?)\**\s*:\s*(.+)$/.exec(line.trim());
+    return item && names.includes(item[1].toLowerCase()) ? item[2].trim() : null;
+}
+/**
+ * Copies each competitor's rows from a card's research onto that competitor's page, so findings
+ * build up across features. A page that already has rows from the card is left alone.
+ * Returns the pages that were changed.
+ */
+export function appendFindings(projectDir, card, research) {
+    const changed = [];
+    for (const competitor of listCompetitors(projectDir)) {
+        const rows = research.split('\n').map(l => rowFor(l, competitor)).filter((r) => r !== null);
+        if (rows.length === 0)
+            continue;
+        const done = withLock(join(projectDir, competitor.path), () => {
+            const current = listCompetitors(projectDir).find(c => c.path === competitor.path);
+            if (current.body.split('\n').some(l => l.startsWith(`- ${card.id} `)))
+                return false;
+            const body = `${current.body.includes('## Findings') ? current.body : `${current.body}\n\n## Findings`}\n\n${rows.map(r => `- ${card.id} ${card.title}: ${r}`).join('\n')}`;
+            writeFileSync(join(projectDir, competitor.path), render({ ...current, body }));
+            return true;
+        });
+        if (!done)
+            continue;
+        writeCloudWikiPage(projectDir, competitor.path);
+        changed.push(competitor.path);
+    }
+    return changed;
+}
+//# sourceMappingURL=competitors.js.map

package/dist/lib/competitors.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,7 @@
+export declare const CONFIG_FILE = ".codeloop/config.yaml";
+/** Never synced and never committed: keys, tokens and paths that are true only on this machine. */
+export declare const LOCAL_FILE = ".codeloop/local.yaml";
+type Values = Record<string, any>;
+/** config.yaml with local.yaml laid over it. Every reader of project config goes through here. */
+export declare function loadConfig(projectDir: string): Values;
+export {};

package/dist/lib/config.js

@@ -0,0 +1,25 @@
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { parse as parseYaml } from 'yaml';
+export const CONFIG_FILE = '.codeloop/config.yaml';
+/** Never synced and never committed: keys, tokens and paths that are true only on this machine. */
+export const LOCAL_FILE = '.codeloop/local.yaml';
+const isMap = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+function read(projectDir, path) {
+    const file = join(projectDir, path);
+    const parsed = existsSync(file) ? parseYaml(readFileSync(file, 'utf-8')) : null;
+    return isMap(parsed) ? parsed : {};
+}
+// Maps merge key by key, so local.yaml can change one agent's command and leave the rest shared.
+// A list or a plain value in local.yaml replaces the shared one.
+function overlay(base, over) {
+    const out = { ...base };
+    for (const [key, value] of Object.entries(over))
+        out[key] = isMap(value) && isMap(base[key]) ? overlay(base[key], value) : value;
+    return out;
+}
+/** config.yaml with local.yaml laid over it. Every reader of project config goes through here. */
+export function loadConfig(projectDir) {
+    return overlay(read(projectDir, CONFIG_FILE), read(projectDir, LOCAL_FILE));
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C,MAAM,CAAC,MAAM,WAAW,GAAG,uBAAuB,CAAC;AACnD,mGAAmG;AACnG,MAAM,CAAC,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAIjD,MAAM,KAAK,GAAG,CAAC,CAAU,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpG,SAAS,IAAI,CAAC,UAAkB,EAAE,IAAY;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChF,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AACrC,CAAC;AAED,iGAAiG;AACjG,iEAAiE;AACjE,SAAS,OAAO,CAAC,IAAY,EAAE,IAAY;IACzC,MAAM,GAAG,GAAW,EAAE,GAAG,IAAI,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACjI,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,OAAO,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAC9E,CAAC"}

package/dist/lib/cron.d.ts

@@ -0,0 +1,5 @@
+export declare function cronError(expr: string): string | null;
+/** Matches in local time, as cron does. */
+export declare function cronMatches(expr: string, date: Date): boolean;
+/** The latest minute in (after, now] that the expression matches, or null. */
+export declare function lastDueSlot(expr: string, after: Date, now: Date): Date | null;

package/dist/lib/cron.js

@@ -0,0 +1,82 @@
+const DOW = ['SUN', 'MON', 'TUE', 'WED', 'THU', 'FRI', 'SAT'];
+// One field: a comma list of `*`, `*/n`, `a`, `a-b` or `a-b/n`. Day names are accepted for day-of-week.
+function parseField(field, min, max, names) {
+    if (field === '*')
+        return null;
+    const unsupported = () => new Error(`unsupported cron field "${field}" (use *, */n, a, a-b, a-b/n or a comma list${names ? '; MON..SUN allowed' : ''}; values ${min}-${max})`);
+    const value = (text) => {
+        const named = names ? names.indexOf(text.toUpperCase()) : -1;
+        const n = named >= 0 ? named : /^\d+$/.test(text) ? parseInt(text, 10) : NaN;
+        if (Number.isNaN(n) || n < min || n > max)
+            throw unsupported();
+        return n;
+    };
+    const out = new Set();
+    for (const part of field.split(',')) {
+        const [range, stepText, extra] = part.split('/');
+        if (extra !== undefined || range === '')
+            throw unsupported();
+        const step = stepText === undefined ? 1 : /^\d+$/.test(stepText) ? parseInt(stepText, 10) : 0;
+        if (step < 1)
+            throw unsupported();
+        const bounds = range === '*' ? [min, max] : range.split('-').map(value);
+        if (bounds.length > 2)
+            throw unsupported();
+        const from = bounds[0];
+        // `5/10` means "from 5 to the end, every 10", as in cron.
+        const to = bounds.length === 2 ? bounds[1] : stepText === undefined ? from : max;
+        if (from > to)
+            throw unsupported();
+        for (let n = from; n <= to; n += step)
+            out.add(n);
+    }
+    return out;
+}
+function parseCron(expr) {
+    const f = expr.trim().split(/\s+/);
+    if (f.length !== 5)
+        throw new Error(`cron "${expr}" must have 5 fields`);
+    const dow = parseField(f[4], 0, 7, DOW);
+    if (dow?.has(7))
+        dow.add(0);
+    return {
+        minute: parseField(f[0], 0, 59),
+        hour: parseField(f[1], 0, 23),
+        dom: parseField(f[2], 1, 31),
+        month: parseField(f[3], 1, 12),
+        dow,
+    };
+}
+export function cronError(expr) {
+    try {
+        parseCron(expr);
+        return null;
+    }
+    catch (e) {
+        return e.message;
+    }
+}
+/** Matches in local time, as cron does. */
+export function cronMatches(expr, date) {
+    const c = parseCron(expr);
+    const ok = (set, v) => set === null || set.has(v);
+    if (!ok(c.minute, date.getMinutes()) || !ok(c.hour, date.getHours()) || !ok(c.month, date.getMonth() + 1)) {
+        return false;
+    }
+    // Standard cron: when both day fields are restricted, either one matching is enough.
+    if (c.dom && c.dow)
+        return c.dom.has(date.getDate()) || c.dow.has(date.getDay());
+    return ok(c.dom, date.getDate()) && ok(c.dow, date.getDay());
+}
+/** The latest minute in (after, now] that the expression matches, or null. */
+export function lastDueSlot(expr, after, now) {
+    const slot = new Date(now);
+    slot.setSeconds(0, 0);
+    while (slot.getTime() > after.getTime()) {
+        if (cronMatches(expr, slot))
+            return slot;
+        slot.setMinutes(slot.getMinutes() - 1);
+    }
+    return null;
+}
+//# sourceMappingURL=cron.js.map

package/dist/lib/cron.js.map

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

package/dist/lib/detect.d.ts

@@ -0,0 +1,13 @@
+export type StackId = 'node-typescript' | 'python' | 'go' | 'generic';
+export type ToolId = 'claude' | 'cursor' | 'codex';
+export interface DetectionResult {
+    stack: StackId;
+    description: string;
+    matchedFile: string | null;
+}
+export declare function detectStack(projectDir: string): DetectionResult;
+/**
+ * Detect which AI coding tools are present in the project.
+ * Looks for tool-specific directories.
+ */
+export declare function detectTools(projectDir: string): ToolId[];

package/dist/lib/detect.js

@@ -0,0 +1,60 @@
+import { existsSync } from 'fs';
+import { join } from 'path';
+const rules = [
+    {
+        stack: 'node-typescript',
+        files: ['tsconfig.json'],
+        description: 'TypeScript (Node.js)',
+    },
+    {
+        stack: 'python',
+        files: ['pyproject.toml', 'setup.py', 'requirements.txt', 'Pipfile'],
+        description: 'Python',
+    },
+    {
+        stack: 'go',
+        files: ['go.mod'],
+        description: 'Go',
+    },
+];
+export function detectStack(projectDir) {
+    for (const rule of rules) {
+        for (const file of rule.files) {
+            if (existsSync(join(projectDir, file))) {
+                return {
+                    stack: rule.stack,
+                    description: rule.description,
+                    matchedFile: file,
+                };
+            }
+        }
+    }
+    return {
+        stack: 'generic',
+        description: 'Generic project',
+        matchedFile: null,
+    };
+}
+/**
+ * Detect which AI coding tools are present in the project.
+ * Looks for tool-specific directories.
+ */
+export function detectTools(projectDir) {
+    const detected = [];
+    // Claude Code: .claude/ directory or CLAUDE.md
+    if (existsSync(join(projectDir, '.claude')) || existsSync(join(projectDir, 'CLAUDE.md'))) {
+        detected.push('claude');
+    }
+    // Cursor: .cursor/ directory or .cursorrules
+    if (existsSync(join(projectDir, '.cursor')) || existsSync(join(projectDir, '.cursorrules'))) {
+        detected.push('cursor');
+    }
+    // Codex: .codex/ directory or AGENTS.md or .agents/
+    if (existsSync(join(projectDir, '.codex')) ||
+        existsSync(join(projectDir, 'AGENTS.md')) ||
+        existsSync(join(projectDir, '.agents'))) {
+        detected.push('codex');
+    }
+    return detected;
+}
+//# sourceMappingURL=detect.js.map

package/dist/lib/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/lib/detect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAW5B,MAAM,KAAK,GAAoB;IAC7B;QACE,KAAK,EAAE,iBAAiB;QACxB,KAAK,EAAE,CAAC,eAAe,CAAC;QACxB,WAAW,EAAE,sBAAsB;KACpC;IACD;QACE,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,CAAC,gBAAgB,EAAE,UAAU,EAAE,kBAAkB,EAAE,SAAS,CAAC;QACpE,WAAW,EAAE,QAAQ;KACtB;IACD;QACE,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,CAAC,QAAQ,CAAC;QACjB,WAAW,EAAE,IAAI;KAClB;CACF,CAAC;AAQF,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;gBACvC,OAAO;oBACL,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,WAAW,EAAE,IAAI;iBAClB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,iBAAiB;QAC9B,WAAW,EAAE,IAAI;KAClB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,+CAA+C;IAC/C,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QACzF,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAED,6CAA6C;IAC7C,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;QAC5F,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAED,oDAAoD;IACpD,IACE,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACtC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACzC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,EACvC,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/lib/engine.d.ts

@@ -0,0 +1,88 @@
+import { RefusalError, type Card, type CardEvent } from './cards.js';
+export { RefusalError };
+import { type Stage } from './lane.js';
+export type Role = 'owner' | 'reviewer' | 'agent';
+export interface EngineConfig {
+    gatesMode: 'all' | 'trusted';
+    gatesPerDay?: number;
+}
+export declare function loadEngineConfig(projectDir: string): EngineConfig;
+/**
+ * `--as`, then CODELOOP_ROLE, then the terminal: a person typing at a TTY is the owner, anything
+ * piped or spawned (an agent, CI, the MCP server) is an agent.
+ */
+export declare function resolveRole(flag?: string, tty?: boolean): Role;
+export type Outcome = 'moved' | 'parked' | 'done' | 'failed' | 'stuck' | 'unchanged';
+export interface AdvanceResult {
+    card: Card;
+    outcome: Outcome;
+    output?: string;
+    started: Card[];
+}
+interface Clock {
+    now?: Date;
+}
+/** True for a public step nobody has approved yet: no work and no check may run for it. */
+export declare const awaitsApproval: (card: Card, stage: Stage) => boolean;
+/** Runs the stage's done command without touching the card. null when the stage has no command. */
+export declare function runCheck(projectDir: string, card: Card, stage: Stage): {
+    passed: boolean;
+    output: string;
+} | null;
+/** Records a spec folder or an evidence path on a card. It never changes the stage or the gate. */
+export declare function annotateCard(projectDir: string, id: string, patch: {
+    spec?: string;
+    evidence?: string;
+}, action: string, opts?: {
+    note?: string;
+    role?: Role;
+} & Clock): Card;
+/**
+ * Appends one event to a card; it never changes the stage or the gate. `build` sees the board the
+ * write is checked against, so a limit it enforces by throwing cannot be passed by two writers.
+ */
+export declare function recordEvent(projectDir: string, id: string, build: (cards: Card[], card: Card) => Pick<CardEvent, 'action'> & Partial<CardEvent>, now?: Date): CardEvent;
+/**
+ * Cards for work that already exists elsewhere (Spec Kit, BMAD). They are an inventory, so the
+ * wip limit does not apply and each lands at the stage its source status maps to.
+ */
+export declare function importCards(projectDir: string, items: {
+    lane: string;
+    title: string;
+    stage?: string;
+    note: string;
+    spec: (id: string) => string;
+}[], now?: Date): Card[];
+/** Started work that is parked at a gate. Proposals are not started work, so they do not use up capacity.gates_per_day. */
+export declare const waitingOnOwner: (cards: Card[]) => number;
+/**
+ * A card that waits for the owner before it enters its lane: `approve` promotes it to the first
+ * stage, `reject` drops it. Nothing starts it. With `dedupe`, a second proposal made from the same
+ * finding returns the first card instead of creating another.
+ */
+export declare function proposeCard(projectDir: string, input: {
+    lane: string;
+    title: string;
+    description?: string;
+    source?: string;
+    dedupe?: string;
+    role?: Role | 'engine';
+} & Clock): {
+    card: Card;
+    created: boolean;
+};
+export declare function createCard(projectDir: string, input: {
+    lane: string;
+    title: string;
+    id?: string;
+    role?: Role;
+    note?: string;
+} & Clock): Card;
+export declare function advanceCard(projectDir: string, ref: string, opts?: {
+    event?: string;
+    unattended?: boolean;
+} & Clock): AdvanceResult;
+export declare function approveCard(projectDir: string, ref: string, role: Role, opts?: {
+    note?: string;
+} & Clock): Card;
+export declare function rejectCard(projectDir: string, ref: string, role: Role, note: string, opts?: Clock): Card;