@sun-asterisk/sungen 3.2.16-beta.7 → 3.2.17

package/src/orchestrator/templates/ai-src/skills/sungen-delivery/SKILL.md

@@ -1,107 +1,21 @@
 ---
 name: sungen-delivery
-description: 'Export the Test Case & Coverage Matrix (or the legacy per-scenario CSV) from Gherkin + Playwright results. Auto-loaded by delivery command.'
+description: 'Export Gherkin scenarios + Playwright results → CSV test case deliverable. Auto-loaded by delivery command.'
 user-invocable: false
 ---
 
 ## Purpose
 
-Export test cases from Sungen units to the QA deliverable. Two modes:
+Export test cases from Sungen screens and flows to a standardized CSV file (format BM-2-901-13) for QA delivery.
 
-- **Matrix (default)** — the **Test Case & Coverage Matrix**: one row per *delivery item* (one
-  target + one test intent + one oracle family); scenarios / `@cases` rows stay as collapsible
-  *coverage variant* sub-rows. Built for review, manual execution, customer hand-off, and
-  reporting — no numbered step dumps.
-- **Legacy (`--legacy`/`--full`)** — the classic per-scenario BM-2-901-13 workbook (documented
-  in the second half of this skill; unchanged).
+**This skill delegates all heavy work to the `sungen delivery` CLI.** The CLI is the single source of truth for parsing logic — do NOT re-parse files in AI. Your role is only to:
 
-**This skill delegates all heavy work to the `sungen delivery` CLI.** The CLI is the single source
-of truth for parsing + gating. The AI's only semantic contribution is **proposing the Delivery
-Map** (grouping) — everything else is: invoke the CLI, show output verbatim, help on failures.
+1. Invoke the CLI
+2. Show its output verbatim
+3. Help the user react to pre-flight failures
 
 ---
 
-## Matrix mode — the Delivery Map
-
-`qa/<screens|flows|api>/<unit>/delivery/<unit>.map.yaml` — committed, AI-proposed
-(`review: proposed`), gate-validated, QA-approved (`sungen delivery --approve` stamps scenario
-fingerprints). Schema + grouping rules live in the delivery command instructions; the normative
-spec is `docs/spec/delivery-coverage-matrix-spec.md`.
-
-**Gates** (CLI `--check`): A source (VP-ids unique, oracle present, Background setup-only) ·
-B mapping (every scenario in exactly one group XOR one disposition) · C aggregation (test layer
-recomputed and equal within a group — **execution mode and priority are coverage dimensions, not
-splits**: mixed items show `Auto n · Manual m` and take the highest variant priority; heuristic
-oracle-shape/precondition mismatches are review-level, silenced once approved and unchanged) ·
-D executability (precondition · condition+
-data · trigger · oracle all renderable; every `{{var}}` resolves; **no template token may survive
-into a rendered cell** — test-data cross-references are resolved for display) · E drift
-(scenario fingerprint mismatch → back to review; the map's OWN reviewed
-wording/grouping is fingerprinted as `__map__` too, so post-approval edits re-open review) · G review state (proposed groups block the official
-render; `--preview` renders a DRAFT watermark) · K category class (a `VP-SEC-*` variant outside
-`category: security`, or `VP-NFR-*` outside `nfr` → warning: the Coverage grid's column would render
-empty and report a false gap) · R requirement coverage (spec FR/TR/NFR ids with no trace and no
-`requirements:` status → warning; **and a `status: covered` override that no variant traces to** →
-warning: tag the proving scenario `@spec:<id>` instead of asserting it in prose) · W wording lint (map intent/oracle containing
-tokens, `[Selector]` refs, DSL phrasing, or generator labels → warning).
-
-**Wording normalization (deterministic, after semantic normalization):** DSL steps render as
-controlled manual-test English without changing meaning — actions in the imperative (`User fill
-[Email] field with X` → `Enter X in the Email field.`), expected results as observable assertions
-(`User see [Jobs] page` → `The Jobs page is displayed.`), preconditions as states (`The user is
-signed out.`). Manual `# Tester verifies:` labels become structured fields: `Setup:` →
-Precondition, `Action:` → Action, `Observable:` → Expected Result, `Oracle:` → a separate
-`Verification method:` line. Sequence-sensitive flows keep event order: actions numbered with
-mid-flow assertions inline as `Verify: …`; only the final Then block is the Expected Result.
-Empty test values render as `(empty)`.
-
-**Output format**: **XLSX only by default** (one artifact). `--format csv` writes the flat CSV
-instead; `--format both` writes both.
-
-**Scope decides strictness**: a **named** unit that is not ready aborts with exit 1 (pass
-`--continue-on-missing` to tolerate it); a **no-argument sweep** exports every ready unit, lists
-every unit it did not export with the reason, and exits 0 as long as it wrote something — a
-scaffolded unit never blocks the ready ones.
-
-**Workbook**: `Testcases` sheet — parent rows + outline-level-1 variant sub-rows for **every**
-item (single-variant included: the sub-row carries the source VP-id, resolved data, and the
-result/evidence entry). Sub-rows are **delta-only**: knowledge common to the whole item
-(precondition, trigger) is written ONCE on the parent; a child repeats only what distinguishes it
-(condition/data, precondition delta, trigger when it differs) plus its own precise oracle and
-execution fields. The parent never carries placeholder text — when triggers differ the cell is
-simply empty and the sub-rows carry them.
-
-Parent preconditions are the **intersection** of the variants' and the parent's Action holds the
-**shared leading steps**; each variant renders only its remaining steps, numbered to continue the
-parent's list — so a shared prefix is written once, not repeated on every child. The parent's
-Coverage cell is the map's short `dimensions:` digest (or the variant refs when none is declared),
-never a concatenation of variant titles.
-
-Variant Result cells hold exactly one of `Passed`/`Failed`/`Blocked`/`Pending`/`N/A` (dropdown) —
-that vocabulary is the contract: the parent Result and the summary band are **live Excel formulas**
-counting those words, so a parent label is always a composed `n/m Passed …` string (`All N/A` when
-every variant is N/A) and never a bare state word. **`N/A` leaves the denominator.** Evidence and
-Defect ID are separate columns; ID + Target frozen; ISO dates; landscape print with repeated
-header rows.
-
-`Coverage` sheet — requirement coverage table (every FR/TR/NFR id with an explicit status),
-target × category grid with explicit `—` gaps, dispositions, manifest. CSV mirrors the same model
-flat with a `Level` column (`item`/`variant`) + a requirement-coverage appendix.
-`delivery_item_count` ≠ progress — variants are the execution metric.
-
-**Data fidelity**: invisible test data is made visible, never normalized — `''` → `(empty)`,
-whitespace-only → `(5 spaces)`, padded → `" value "` quoted verbatim. A trim/collapse here would
-silently break the whitespace tests it describes.
-
-**Authoring guidance the matrix rewards** (create-test side): payload/provider matrices (SQLi
-payload lists, OAuth provider sets) belong in `@cases` datasets so each case is an atomic,
-independently-reportable variant; keep dataset `case:` labels short and stable (`CHK-EMAIL-I1`),
-with descriptions in other columns — the label is part of the variant's identity.
-
----
-
-## Legacy mode (--legacy / --full)
-
 ## Architecture
 
 ```

package/src/orchestrator/templates/ai-src/skills/sungen-gherkin-syntax/SKILL.md

@@ -39,6 +39,7 @@ User uncheck [T] checkbox | toggle
 User select [T] dropdown with {{v}}
 User click [T] button | tab | column | breadcrumb
 User click [T] row with {{v}}
+User try to click [T] button | link          # DISABLED element only — see rule below (v3.3)
 User double click [T] element
 User hover [T] icon | row
 User drag [T] to [T2]
@@ -47,6 +48,12 @@ User expand | collapse [T] row
 
 **click + with {{Value}} rule**: NO value for static (`button`, `link`, `icon`, `tab`). WITH value only for dynamic lists (`row`, `item`, `card`, `option`).
 
+**try to click rule** (v3.3, web only): use ONLY when the element is expected to be DISABLED and the
+scenario asserts nothing happens (cooldown re-send, submit before the form is valid). `click` waits for
+`enabled` → it can only time out there; `try to click` compiles to `.click({ force: true })`. Always
+pair it with the proof: `Then User see [T] TYPE is disabled` + an assertion that the effect did NOT occur.
+NEVER use it for a click that is supposed to work — it deletes the actionability wait.
+
 ### Alert / Keyboard / Wait / Scroll
 
 ```

package/dist/exporters/matrix/build.d.ts

@@ -1,61 +0,0 @@
-/**
- * Build the matrix model: derive atomic coverage variants from the merged
- * feature/spec view, assemble delivery items per the Delivery Map, attach
- * per-variant Playwright results, and roll parents up (derived only — Gate F
- * is structural: there is no independent parent result input).
- */
-import { FeatureMetadata, PlaywrightResult } from '../types';
-import { MergedScenario } from '../scenario-merger';
-import { CoverageVariant, DeliveryItem, DeliveryMap, ItemResult, VariantState, MatrixModel, RequirementCoverage } from './types';
-export interface BuildInputs {
-    unit: string;
-    feature: FeatureMetadata;
-    merged: MergedScenario[];
-    testData: Record<string, string> | null;
-    results: Map<string, PlaywrightResult> | null;
-    map: DeliveryMap;
-    transformerVersion: string;
-    /** requirements/spec.md content — source of the requirement-id inventory (FR/TR/NFR). */
-    specText?: string;
-}
-/**
- * Derive every atomic coverage variant of the unit (one per scenario, or one per
- * `@cases` dataset row). Exported separately so the gates + the map-proposal
- * support tooling see the same universe the builder does.
- */
-export declare function deriveVariants(inputs: Pick<BuildInputs, 'feature' | 'merged' | 'testData' | 'results'>): CoverageVariant[];
-/**
- * Make invisible test data VISIBLE instead of losing it (review GAP-04):
- * '' → (empty) · whitespace-only → (N spaces) · padded → quoted verbatim.
- * The canonical value is never changed — only its presentation.
- */
-export declare function displayValue(v: string): string;
-/**
- * Requirement inventory ∪ traces → coverage table. Ids are scanned from the spec
- * text (FR-/TR-/NFR-<n>); map overrides win over the derived covered/gap status.
- */
-export declare function computeRequirements(specText: string, map: DeliveryMap, items: DeliveryItem[]): RequirementCoverage[];
-/**
- * The exact word rendered in a variant's Result cell. This is the SINGLE
- * vocabulary both the renderers and the parent's COUNTIF roll-up use — the
- * legacy exporter's statusToTestResult disagreed on two statuses (`skipped`
- * showed N/A but counted as not-run; `interrupted` showed Pending but counted
- * as blocked), which silently skewed the derived parent result.
- */
-export declare function variantState(v: CoverageVariant): VariantState;
-/**
- * Derived parent result — precedence failed → blocked → all-N/A → not_run →
- * partial → passed. `N/A` variants leave the denominator (an intentionally
- * skipped case must not make the parent look incomplete).
- */
-export declare function rollUp(variants: CoverageVariant[]): {
-    result: ItemResult;
-    counts: DeliveryItem['resultCounts'];
-};
-/**
- * Expand one map variant ref to concrete variant refs:
- * a bare VP-id whose scenario has a dataset means ALL its rows.
- */
-export declare function expandMapRef(ref: string, variantsByVp: Map<string, CoverageVariant[]>): CoverageVariant[];
-export declare function buildMatrix(inputs: BuildInputs): MatrixModel;
-//# sourceMappingURL=build.d.ts.map

package/dist/exporters/matrix/build.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/exporters/matrix/build.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAUpD,OAAO,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EAGZ,WAAW,EACX,mBAAmB,EAEpB,MAAM,SAAS,CAAC;AAwDjB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACxC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,IAAI,CAAC;IAC9C,GAAG,EAAE,WAAW,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC,GAAG,eAAe,EAAE,CAwI1H;AAgBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9C;AASD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,YAAY,EAAE,GACpB,mBAAmB,EAAE,CAuBvB;AAyBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,eAAe,GAAG,YAAY,CAW7D;AAMD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC,cAAc,CAAC,CAAA;CAAE,CAYhH;AAUD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,GAAG,eAAe,EAAE,CAMzG;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CA8G5D"}