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.
Files changed (43) hide show
  1. package/.claude-plugin/marketplace.json +26 -0
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/CHANGELOG.md +83 -0
  4. package/README.md +123 -12
  5. package/agents/qa-diff-indexer-agent.md +81 -0
  6. package/agents/qa-gather-agent.md +21 -4
  7. package/agents/qa-page-mapper-agent.md +74 -0
  8. package/agents/qa-reporting-agent.md +103 -0
  9. package/bin/qualiow +49 -0
  10. package/data/knowledge/manifest.yml +22 -0
  11. package/dist/cli/index.js +1111 -62
  12. package/dist/index.d.ts +91 -2
  13. package/dist/index.js +532 -48
  14. package/docs/GETTING-STARTED.md +127 -8
  15. package/hooks/hooks.json +27 -0
  16. package/hooks/scripts/read-guard.mjs +95 -0
  17. package/hooks/scripts/secret-patterns.d.mts +8 -0
  18. package/hooks/scripts/secret-patterns.mjs +136 -0
  19. package/hooks/scripts/write-guard.mjs +87 -0
  20. package/package.json +3 -2
  21. package/skills/qa-explore/SKILL.md +2 -1
  22. package/skills/qa-explore/phases/00-setup.md +16 -8
  23. package/skills/qa-explore/phases/03-discovery.md +48 -6
  24. package/skills/qa-explore/phases/07-reporting.md +36 -15
  25. package/skills/qa-explore/references/delegation-rules.md +82 -0
  26. package/skills/qa-explore/references/output-contract.md +7 -2
  27. package/skills/qa-explore/references/paths.md +25 -1
  28. package/skills/qa-explore/references/security-rules.md +4 -0
  29. package/skills/qa-explore/references/session-rules.md +2 -1
  30. package/skills/qa-explore-cleanup/SKILL.md +44 -19
  31. package/skills/qa-explore-feedback/SKILL.md +5 -0
  32. package/skills/qa-explore-mobile/SKILL.md +1 -1
  33. package/skills/qa-explore-mobile/phases/07-reporting.md +33 -11
  34. package/skills/qa-explore-quick/SKILL.md +12 -2
  35. package/skills/qa-explore-report/SKILL.md +29 -5
  36. package/skills/qa-gather/SKILL.md +30 -9
  37. package/skills/qa-knowledge-add/SKILL.md +10 -5
  38. package/skills/qa-knowledge-list/SKILL.md +28 -40
  39. package/skills/qa-verify-backend/SKILL.md +7 -4
  40. package/skills/qa-verify-backend/phases/02-static-review.md +11 -0
  41. package/skills/qa-verify-backend/phases/03-live-verification.md +3 -1
  42. package/skills/qa-verify-backend/phases/03b-api-verification.md +3 -1
  43. 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
- declare function runList(type: string, cwd: string): Promise<void>;
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 };