qualiow-exploratory-testing 2.0.0 → 2.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +26 -0
- package/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +83 -0
- package/README.md +123 -12
- package/agents/qa-diff-indexer-agent.md +81 -0
- package/agents/qa-gather-agent.md +21 -4
- package/agents/qa-page-mapper-agent.md +74 -0
- package/agents/qa-reporting-agent.md +103 -0
- package/bin/qualiow +49 -0
- package/data/knowledge/manifest.yml +22 -0
- package/dist/cli/index.js +1111 -62
- package/dist/index.d.ts +91 -2
- package/dist/index.js +532 -48
- package/docs/GETTING-STARTED.md +127 -8
- package/hooks/hooks.json +27 -0
- package/hooks/scripts/read-guard.mjs +95 -0
- package/hooks/scripts/secret-patterns.d.mts +8 -0
- package/hooks/scripts/secret-patterns.mjs +136 -0
- package/hooks/scripts/write-guard.mjs +87 -0
- package/package.json +3 -2
- package/skills/qa-explore/SKILL.md +2 -1
- package/skills/qa-explore/phases/00-setup.md +16 -8
- package/skills/qa-explore/phases/03-discovery.md +48 -6
- package/skills/qa-explore/phases/07-reporting.md +36 -15
- package/skills/qa-explore/references/delegation-rules.md +82 -0
- package/skills/qa-explore/references/output-contract.md +7 -2
- package/skills/qa-explore/references/paths.md +25 -1
- package/skills/qa-explore/references/security-rules.md +4 -0
- package/skills/qa-explore/references/session-rules.md +2 -1
- package/skills/qa-explore-cleanup/SKILL.md +44 -19
- package/skills/qa-explore-feedback/SKILL.md +5 -0
- package/skills/qa-explore-mobile/SKILL.md +1 -1
- package/skills/qa-explore-mobile/phases/07-reporting.md +33 -11
- package/skills/qa-explore-quick/SKILL.md +12 -2
- package/skills/qa-explore-report/SKILL.md +29 -5
- package/skills/qa-gather/SKILL.md +30 -9
- package/skills/qa-knowledge-add/SKILL.md +10 -5
- package/skills/qa-knowledge-list/SKILL.md +28 -40
- package/skills/qa-verify-backend/SKILL.md +7 -4
- package/skills/qa-verify-backend/phases/02-static-review.md +11 -0
- package/skills/qa-verify-backend/phases/03-live-verification.md +3 -1
- package/skills/qa-verify-backend/phases/03b-api-verification.md +3 -1
- package/skills/qa-verify-backend/phases/05-reporting.md +51 -19
package/dist/index.d.ts
CHANGED
|
@@ -681,6 +681,7 @@ declare const LoadingStrategySchema: z.ZodObject<{
|
|
|
681
681
|
always: z.ZodArray<z.ZodString>;
|
|
682
682
|
by_domain: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
|
|
683
683
|
by_tag: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
|
|
684
|
+
by_skill: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
|
|
684
685
|
}, z.core.$strip>;
|
|
685
686
|
declare const KnowledgeManifestSchema: z.ZodObject<{
|
|
686
687
|
version: z.ZodString;
|
|
@@ -699,6 +700,7 @@ declare const KnowledgeManifestSchema: z.ZodObject<{
|
|
|
699
700
|
always: z.ZodArray<z.ZodString>;
|
|
700
701
|
by_domain: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
|
|
701
702
|
by_tag: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
|
|
703
|
+
by_skill: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
|
|
702
704
|
}, z.core.$strip>;
|
|
703
705
|
entries: z.ZodArray<z.ZodObject<{
|
|
704
706
|
id: z.ZodString;
|
|
@@ -877,6 +879,16 @@ declare function appendSessionMetricsDeduped(outputDir: string, metrics: Session
|
|
|
877
879
|
declare const SESSION_KINDS: readonly ["explore", "quick", "mobile", "backend"];
|
|
878
880
|
type SessionKind = (typeof SESSION_KINDS)[number];
|
|
879
881
|
declare const SESSION_DIR_RE: RegExp;
|
|
882
|
+
/**
|
|
883
|
+
* DISCOVERY ONLY — directories written before the current scheme existed:
|
|
884
|
+
* a `YYYY-MM-DD` prefix, an optional `HHmm`, then any remainder
|
|
885
|
+
* (`2026-05-22-1045-demo-target`, `2026-07-09-quick-preprod-product-search`).
|
|
886
|
+
*
|
|
887
|
+
* Never use this to create or validate a new directory name: `SESSION_DIR_RE`
|
|
888
|
+
* stays the only writer. It exists so `prune` and the unindexed scan can see
|
|
889
|
+
* output an upgraded project already has on disk.
|
|
890
|
+
*/
|
|
891
|
+
declare const LEGACY_SESSION_DIR_RE: RegExp;
|
|
880
892
|
/**
|
|
881
893
|
* Turns an arbitrary target id, ticket or URL into a filesystem-safe slug:
|
|
882
894
|
* lowercase, alphanumerics and single dashes, no leading/trailing dash,
|
|
@@ -894,6 +906,20 @@ interface ParsedSessionDir {
|
|
|
894
906
|
}
|
|
895
907
|
/** Parses a directory name back into its parts, or null if it does not match. */
|
|
896
908
|
declare function parseSessionDirName(name: string): ParsedSessionDir | null;
|
|
909
|
+
interface DiscoveredSessionDir {
|
|
910
|
+
/** The directory name as it is on disk. */
|
|
911
|
+
name: string;
|
|
912
|
+
/** Start of the session in local time; midnight when the name carries no `HHmm`. */
|
|
913
|
+
timestamp: Date;
|
|
914
|
+
/** True when the name predates the current `<YYYY-MM-DD-HHmm>-<kind>-<slug>` scheme. */
|
|
915
|
+
legacy: boolean;
|
|
916
|
+
}
|
|
917
|
+
/**
|
|
918
|
+
* Describes a session directory found on disk — current scheme or legacy — so
|
|
919
|
+
* `prune` and the unindexed scan can treat both. Returns null when the name
|
|
920
|
+
* carries no date prefix at all, which is what keeps unrelated directories out.
|
|
921
|
+
*/
|
|
922
|
+
declare function describeSessionDir(name: string): DiscoveredSessionDir | null;
|
|
897
923
|
|
|
898
924
|
/**
|
|
899
925
|
* Minimal GitHub-flavoured-markdown table parser.
|
|
@@ -938,6 +964,23 @@ declare const INDEX_COLUMNS: readonly ["Date", "Kind", "Target", "Bugs", "Durati
|
|
|
938
964
|
declare const ALL_BUGS_COLUMNS: readonly ["ID", "Session", "Title", "Severity", "Status", "Report"];
|
|
939
965
|
declare const INDEX_MD_HEADER: string;
|
|
940
966
|
declare const ALL_BUGS_MD_HEADER: string;
|
|
967
|
+
/**
|
|
968
|
+
* True when a table's own header is the canonical column set — same names in the
|
|
969
|
+
* same order, compared case-insensitively.
|
|
970
|
+
*/
|
|
971
|
+
declare function headersMatchColumns(headers: readonly string[], columns: readonly string[]): boolean;
|
|
972
|
+
/**
|
|
973
|
+
* Canonical columns a table's header does not carry, in canonical order — what a
|
|
974
|
+
* file written by an earlier version is missing.
|
|
975
|
+
*/
|
|
976
|
+
declare function missingColumns(headers: readonly string[], columns: readonly string[]): string[];
|
|
977
|
+
/**
|
|
978
|
+
* Renders one row in a table's OWN column order, taking each cell from `values`
|
|
979
|
+
* keyed by lower-cased column name. A column with no value is left empty, so an
|
|
980
|
+
* index written by an earlier version keeps its width instead of gaining cells
|
|
981
|
+
* that would shift every value one column to the right when read back.
|
|
982
|
+
*/
|
|
983
|
+
declare function buildTableRow(headers: readonly string[], values: Record<string, string>): string;
|
|
941
984
|
|
|
942
985
|
/**
|
|
943
986
|
* .gitignore merge for `qualiow init`.
|
|
@@ -975,6 +1018,21 @@ declare function resolveSkillsSource(pkgRoot: string): string | null;
|
|
|
975
1018
|
* report a useful "not found").
|
|
976
1019
|
*/
|
|
977
1020
|
declare function resolveTargetPath(cwd: string, name: string | undefined, pkgRoot?: string): string;
|
|
1021
|
+
/**
|
|
1022
|
+
* Resolve the `data/` directory the read-only commands read from.
|
|
1023
|
+
*
|
|
1024
|
+
* Order, first existing wins:
|
|
1025
|
+
* 1. an explicit directory (`--data`), resolved against `cwd`
|
|
1026
|
+
* 2. `<cwd>/data`, but only when it carries `knowledge/manifest.yml` — the
|
|
1027
|
+
* marker that this is a qualiow project rather than any `data/` folder
|
|
1028
|
+
* 3. `$CLAUDE_PLUGIN_ROOT/data`, set by Claude Code under a plugin install
|
|
1029
|
+
* 4. `<pkgRoot>/data`, the package's own shipped data
|
|
1030
|
+
*
|
|
1031
|
+
* An explicit directory is returned as given even when it does not exist, so a
|
|
1032
|
+
* typo surfaces as a "not found" naming the path the caller asked for instead
|
|
1033
|
+
* of silently falling back to the package data.
|
|
1034
|
+
*/
|
|
1035
|
+
declare function resolveDataDir(cwd: string, explicit?: string, pkgRoot?: string): string;
|
|
978
1036
|
/** Resolve a domain config, trying `<id>.yml` then `_<id>.yml`. */
|
|
979
1037
|
declare function resolveDomainPath(dataDir: string, id: string): string;
|
|
980
1038
|
|
|
@@ -1150,6 +1208,7 @@ interface InitOptions {
|
|
|
1150
1208
|
includeExamples: boolean;
|
|
1151
1209
|
force: boolean;
|
|
1152
1210
|
dryRun: boolean;
|
|
1211
|
+
hooks?: boolean;
|
|
1153
1212
|
}
|
|
1154
1213
|
type CopyStatus = 'installed' | 'unchanged' | 'overwritten' | 'skipped';
|
|
1155
1214
|
interface CopyRecord {
|
|
@@ -1202,7 +1261,23 @@ declare function runReport(options: ReportOptions, ctx: {
|
|
|
1202
1261
|
*/
|
|
1203
1262
|
declare function resolveSessionDir(sessionsDir: string, sessionId: string): string;
|
|
1204
1263
|
|
|
1205
|
-
|
|
1264
|
+
interface ListOptions {
|
|
1265
|
+
/** Knowledge only: keep entries carrying this domain (or `all`). */
|
|
1266
|
+
domain?: string;
|
|
1267
|
+
/** Knowledge only: keep entries carrying this tag. */
|
|
1268
|
+
tag?: string;
|
|
1269
|
+
/** Knowledge only: keep entries of this type. */
|
|
1270
|
+
type?: string;
|
|
1271
|
+
/** Knowledge only: print one entry's YAML file instead of the listing. */
|
|
1272
|
+
entry?: string;
|
|
1273
|
+
/** Knowledge only: print the release changelog instead of the listing. */
|
|
1274
|
+
changelog?: boolean;
|
|
1275
|
+
/** Knowledge only: print stats, releases and loading-strategy counts. */
|
|
1276
|
+
stats?: boolean;
|
|
1277
|
+
/** Knowledge only: read the knowledge base from this data directory. */
|
|
1278
|
+
data?: string;
|
|
1279
|
+
}
|
|
1280
|
+
declare function runList(type: string, cwd: string, options?: ListOptions, log?: (line: string) => void): Promise<void>;
|
|
1206
1281
|
interface SessionRow {
|
|
1207
1282
|
date: string;
|
|
1208
1283
|
kind: string;
|
|
@@ -1226,5 +1301,19 @@ interface ValidateOptions {
|
|
|
1226
1301
|
declare function runValidate(options: ValidateOptions, cwd: string): number;
|
|
1227
1302
|
|
|
1228
1303
|
declare function runKb(mode: 'sync' | 'check', cwd: string): SyncResult;
|
|
1304
|
+
interface KbDigestOptions {
|
|
1305
|
+
domain?: string;
|
|
1306
|
+
tag?: string[];
|
|
1307
|
+
/** `--for <skill>`; commander stores it under the flag's own name. */
|
|
1308
|
+
for?: string;
|
|
1309
|
+
entry?: string;
|
|
1310
|
+
data?: string;
|
|
1311
|
+
maxLines?: number;
|
|
1312
|
+
}
|
|
1313
|
+
/**
|
|
1314
|
+
* Builds the digest a session loads instead of reading the manifest and the
|
|
1315
|
+
* release files whole. Returns the text; the action prints it.
|
|
1316
|
+
*/
|
|
1317
|
+
declare function runKbDigest(options: KbDigestOptions, cwd: string): string;
|
|
1229
1318
|
|
|
1230
|
-
export { ALL_BUGS_COLUMNS, ALL_BUGS_MD_HEADER, type AnyTargetConfig, type AuthConfig, AuthConfigSchema, type BrowserConfig, BrowserConfigSchema, type BugReport, type BugSeverity, CONFIDENTIALITY_HEADER_MD, CONFIDENTIALITY_LINES, CONFIDENTIALITY_NOTICE, type CopyRecord, type CopyStatus, type CoverageEntry, type DomainConfig, DomainConfigSchema, INDEX_COLUMNS, INDEX_MD_HEADER, type InitOptions, type InitResult, type Journey, JourneySchema, KnowledgeChangelogSchema, type KnowledgeEntry, type KnowledgeEntryContent, KnowledgeEntryContentSchema, KnowledgeEntrySchema, type KnowledgeManifest, type KnowledgeManifestEntry, KnowledgeManifestEntrySchema, KnowledgeManifestSchema, type KnowledgeManifestStats, KnowledgeManifestStatsSchema, KnowledgeReleaseSchema, type LoadingStrategy, LoadingStrategySchema, type ManifestStats, type MobileAppConfig, MobileAppConfigSchema, type MobileDeviceConfig, MobileDeviceConfigSchema, type MobileScopeConfig, MobileScopeConfigSchema, type MobileTargetConfig, MobileTargetConfigSchema, type MobileWebConfig, MobileWebConfigSchema, type ParsedBug, type ParsedSession, type ParsedSessionDir, type ParsedTable, QUALIOW_GITIGNORE_ENTRIES, QUALIOW_GITIGNORE_HEADER, REDACTION_CATEGORIES, type RedactOptions, type RegistryEntry, type ReportMeta, type RiskRanking, SESSION_DIR_RE, SESSION_KINDS, type SafetyConfig, SafetyConfigSchema, type ScopeConfig, ScopeConfigSchema, type SessionKind, type SessionMetrics, SessionMetricsSchema, type SeverityCounts, SeverityCountsSchema, type SourceRepoConfig, SourceRepoConfigSchema, type SyncResult, type TargetConfig, TargetConfigSchema, type ValidationError, type ValidationResult, WebTargetConfigSchema, appendSessionMetrics, appendSessionMetricsDeduped, buildManifestRegistry, computeStats, containsSecrets, csvEscape, extractCoverage, extractListSection, extractReportMeta, generateHtmlReport, generateJiraExport, generateJsonReport, generateMarkdownSummary, getPackageRoot, getPackageVersion, hasConfidentialityHeader, listReleaseDirs, loadSessionForOutput, mergeGitignore, parseBugReport, parseMarkdownTable, parseSession, parseSessionDirName, parseTimeBox, readAllMetrics, readSessionIndex, redact, resolveDomainPath, resolveSessionDir, resolveSkillsSource, resolveTargetPath, runExplore, runInit, runKb, runList, runReport, runValidate, sessionDirName, sessionTimestamp, slugify, syncKnowledgeManifest, validateAllConfigs, validateDomainConfig, validateKnowledgeBase, validateKnowledgeEntry, validateTargetConfig };
|
|
1319
|
+
export { ALL_BUGS_COLUMNS, ALL_BUGS_MD_HEADER, type AnyTargetConfig, type AuthConfig, AuthConfigSchema, type BrowserConfig, BrowserConfigSchema, type BugReport, type BugSeverity, CONFIDENTIALITY_HEADER_MD, CONFIDENTIALITY_LINES, CONFIDENTIALITY_NOTICE, type CopyRecord, type CopyStatus, type CoverageEntry, type DiscoveredSessionDir, type DomainConfig, DomainConfigSchema, INDEX_COLUMNS, INDEX_MD_HEADER, type InitOptions, type InitResult, type Journey, JourneySchema, type KbDigestOptions, KnowledgeChangelogSchema, type KnowledgeEntry, type KnowledgeEntryContent, KnowledgeEntryContentSchema, KnowledgeEntrySchema, type KnowledgeManifest, type KnowledgeManifestEntry, KnowledgeManifestEntrySchema, KnowledgeManifestSchema, type KnowledgeManifestStats, KnowledgeManifestStatsSchema, KnowledgeReleaseSchema, LEGACY_SESSION_DIR_RE, type ListOptions, type LoadingStrategy, LoadingStrategySchema, type ManifestStats, type MobileAppConfig, MobileAppConfigSchema, type MobileDeviceConfig, MobileDeviceConfigSchema, type MobileScopeConfig, MobileScopeConfigSchema, type MobileTargetConfig, MobileTargetConfigSchema, type MobileWebConfig, MobileWebConfigSchema, type ParsedBug, type ParsedSession, type ParsedSessionDir, type ParsedTable, QUALIOW_GITIGNORE_ENTRIES, QUALIOW_GITIGNORE_HEADER, REDACTION_CATEGORIES, type RedactOptions, type RegistryEntry, type ReportMeta, type RiskRanking, SESSION_DIR_RE, SESSION_KINDS, type SafetyConfig, SafetyConfigSchema, type ScopeConfig, ScopeConfigSchema, type SessionKind, type SessionMetrics, SessionMetricsSchema, type SessionRow, type SeverityCounts, SeverityCountsSchema, type SourceRepoConfig, SourceRepoConfigSchema, type SyncResult, type TargetConfig, TargetConfigSchema, type ValidationError, type ValidationResult, WebTargetConfigSchema, appendSessionMetrics, appendSessionMetricsDeduped, buildManifestRegistry, buildTableRow, computeStats, containsSecrets, csvEscape, describeSessionDir, extractCoverage, extractListSection, extractReportMeta, generateHtmlReport, generateJiraExport, generateJsonReport, generateMarkdownSummary, getPackageRoot, getPackageVersion, hasConfidentialityHeader, headersMatchColumns, listReleaseDirs, loadSessionForOutput, mergeGitignore, missingColumns, parseBugReport, parseMarkdownTable, parseSession, parseSessionDirName, parseTimeBox, readAllMetrics, readSessionIndex, redact, resolveDataDir, resolveDomainPath, resolveSessionDir, resolveSkillsSource, resolveTargetPath, runExplore, runInit, runKb, runKbDigest, runList, runReport, runValidate, sessionDirName, sessionTimestamp, slugify, syncKnowledgeManifest, validateAllConfigs, validateDomainConfig, validateKnowledgeBase, validateKnowledgeEntry, validateTargetConfig };
|