@hover-dev/core 0.16.0 → 0.17.0

package/dist/specs/writeCaseCsv.d.ts

@@ -1,28 +0,0 @@
-import type { SkillStep } from '../skills/writeSkill.js';
-import type { SpecAssertion } from './writeSpec.js';
-export declare class CaseCsvExistsError extends Error {
-    readonly slug: string;
-    readonly path: string;
-    constructor(slug: string, path: string);
-}
-export interface WriteCaseCsvOptions {
-    devRoot: string;
-    name: string;
-    description?: string;
-    steps: SkillStep[];
-    assertions?: SpecAssertion[];
-    /** Optional Jira project key prefix (e.g. "PROJ"). Goes into Labels so
-     *  the importer can route the test cases without rewriting the CSV.
-     *  Stripped of whitespace; if empty, no project label is added. */
-    jiraProjectKey?: string;
-    /** Free-form labels appended after the default "hover" label. Split
-     *  on commas/whitespace and lowercased. */
-    labels?: string;
-    overwrite?: boolean;
-}
-export interface WriteCaseCsvResult {
-    path: string;
-    slug: string;
-}
-export declare function writeCaseCsv(opts: WriteCaseCsvOptions): Promise<WriteCaseCsvResult>;
-//# sourceMappingURL=writeCaseCsv.d.ts.map

package/dist/specs/writeCaseCsv.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"writeCaseCsv.d.ts","sourceRoot":"","sources":["../../src/specs/writeCaseCsv.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,qBAAa,kBAAmB,SAAQ,KAAK;aACf,IAAI,EAAE,MAAM;aAAkB,IAAI,EAAE,MAAM;gBAA1C,IAAI,EAAE,MAAM,EAAkB,IAAI,EAAE,MAAM;CAIvE;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B;;uEAEmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;+CAC2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE;AAEnE,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiBzF"}

package/dist/specs/writeCaseCsv.js

@@ -1,134 +0,0 @@
-/**
- * Save a completed Hover session as an Xray-compatible test case CSV
- * (one file per session, multi-row layout — one row per replayable step).
- *
- * Target: Atlassian Marketplace's #1 test management for Jira (Xray,
- * ~10M users, ~100M test cases / month). The same CSV imports cleanly
- * into Zephyr Scale and the original Jira issue importer with minor
- * column mapping, so this is the broadest single-format hand-off into
- * a team's test management.
- *
- * Schema (Xray Test Case Importer — multi-row layout):
- *
- *   Issue Id        unique grouping key, repeated on every row of the
- *                   same test case. We use the slug.
- *   Summary         the test case title; set on the FIRST row only.
- *   Test Type       "Manual" for everything Hover emits.
- *   Priority        "Medium" by default; PMs can edit post-import.
- *   Labels          space-separated; "hover" plus the user-supplied set.
- *   Action          one human-readable imperative per row. Reuses the
- *                   humanSteps helper that also feeds the .spec.ts JSDoc.
- *   Expected Result attached to the LAST row of the case. Carries
- *                   assertion hints if present, else the agent's
- *                   done-summary first sentence.
- *
- * The "Issue Id" column is what tells Xray's importer that consecutive
- * rows belong to the same test, even though only the first row has a
- * Summary. The "Test Type" column tells it to instantiate the Manual
- * Test issue type and use the Step / Expected Result fields.
- */
-import { mkdir, writeFile } from 'node:fs/promises';
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { humanSteps } from './humanSteps.js';
-import { slugify, firstSentence } from './text.js';
-export class CaseCsvExistsError extends Error {
-    slug;
-    path;
-    constructor(slug, path) {
-        super(`Test case CSV "${slug}" already exists at ${path}`);
-        this.slug = slug;
-        this.path = path;
-        this.name = 'CaseCsvExistsError';
-    }
-}
-export async function writeCaseCsv(opts) {
-    const slug = slugify(opts.name);
-    if (!slug)
-        throw new Error('case name must contain at least one alphanumeric character');
-    if (!opts.steps.some(s => s.kind === 'step')) {
-        throw new Error('case must contain at least one tool step to describe');
-    }
-    const dir = join(opts.devRoot, '__vibe_tests__');
-    const path = join(dir, `${slug}.case.csv`);
-    if (!opts.overwrite && existsSync(path)) {
-        throw new CaseCsvExistsError(slug, path);
-    }
-    await mkdir(dir, { recursive: true });
-    const csv = renderCsv(slug, opts);
-    await writeFile(path, csv, 'utf-8');
-    return { path, slug };
-}
-// ───────── helpers ─────────
-function renderCsv(slug, opts) {
-    const rows = buildRows(slug, opts);
-    // CRLF row terminator — what Excel / Numbers / Xray's importer all
-    // assume by default. Comma column delimiter, fields with commas or
-    // newlines get wrapped in double-quotes (escaped by doubling).
-    const header = ['Issue Id', 'Summary', 'Test Type', 'Priority', 'Labels', 'Action', 'Expected Result'];
-    const lines = [header.map(escapeField).join(',')];
-    for (const r of rows)
-        lines.push(r.map(escapeField).join(','));
-    return lines.join('\r\n') + '\r\n';
-}
-function buildRows(slug, opts) {
-    const actions = humanSteps(opts.steps);
-    const summary = opts.description?.trim() || opts.name;
-    const expectedTail = expectedFor(opts.assertions ?? [], opts.steps);
-    const labels = buildLabels(opts.jiraProjectKey, opts.labels);
-    // Multi-row layout: one row per Action. First row carries the
-    // test-case-level fields (Summary, Test Type, Priority, Labels); the
-    // rest carry only the Issue Id + Action so Xray groups them.
-    if (actions.length === 0) {
-        // Defensive — writeCaseCsv() already throws on no replayable steps,
-        // but keep a single-row fallback so the file is still well-formed.
-        return [[slug, summary, 'Manual', 'Medium', labels, '(no replayable steps were captured)', expectedTail]];
-    }
-    const rows = [];
-    actions.forEach((action, i) => {
-        const isFirst = i === 0;
-        const isLast = i === actions.length - 1;
-        rows.push([
-            slug,
-            isFirst ? summary : '',
-            isFirst ? 'Manual' : '',
-            isFirst ? 'Medium' : '',
-            isFirst ? labels : '',
-            action,
-            isLast ? expectedTail : '',
-        ]);
-    });
-    return rows;
-}
-function expectedFor(assertions, steps) {
-    if (assertions.length > 0) {
-        return assertions.map(a => `• ${a.hint ?? a.code}`).join('\n');
-    }
-    const done = [...steps].reverse().find(s => s.kind === 'done');
-    if (done?.summary) {
-        return firstSentence(done.summary);
-    }
-    return '';
-}
-function buildLabels(jiraProjectKey, labels) {
-    const set = new Set(['hover']);
-    if (jiraProjectKey?.trim())
-        set.add(jiraProjectKey.trim().toLowerCase());
-    if (labels?.trim()) {
-        labels.split(/[\s,]+/).filter(Boolean).forEach(l => set.add(l.toLowerCase()));
-    }
-    // Xray and Jira both accept space-separated labels in a single cell.
-    return [...set].join(' ');
-}
-/**
- * RFC 4180 escaping: any field containing a quote, comma, CR, or LF
- * gets wrapped in double-quotes; embedded quotes are doubled.
- */
-function escapeField(value) {
-    if (value === '')
-        return '';
-    if (/[",\r\n]/.test(value)) {
-        return `"${value.replace(/"/g, '""')}"`;
-    }
-    return value;
-}