qualiow-exploratory-testing 2.0.0 → 2.2.0

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 +65 -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 +30 -0
  10. package/data/knowledge/manifest.yml +22 -0
  11. package/dist/cli/index.js +876 -43
  12. package/dist/index.d.ts +50 -2
  13. package/dist/index.js +474 -29
  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;
@@ -975,6 +977,21 @@ declare function resolveSkillsSource(pkgRoot: string): string | null;
975
977
  * report a useful "not found").
976
978
  */
977
979
  declare function resolveTargetPath(cwd: string, name: string | undefined, pkgRoot?: string): string;
980
+ /**
981
+ * Resolve the `data/` directory the read-only commands read from.
982
+ *
983
+ * Order, first existing wins:
984
+ * 1. an explicit directory (`--data`), resolved against `cwd`
985
+ * 2. `<cwd>/data`, but only when it carries `knowledge/manifest.yml` — the
986
+ * marker that this is a qualiow project rather than any `data/` folder
987
+ * 3. `$CLAUDE_PLUGIN_ROOT/data`, set by Claude Code under a plugin install
988
+ * 4. `<pkgRoot>/data`, the package's own shipped data
989
+ *
990
+ * An explicit directory is returned as given even when it does not exist, so a
991
+ * typo surfaces as a "not found" naming the path the caller asked for instead
992
+ * of silently falling back to the package data.
993
+ */
994
+ declare function resolveDataDir(cwd: string, explicit?: string, pkgRoot?: string): string;
978
995
  /** Resolve a domain config, trying `<id>.yml` then `_<id>.yml`. */
979
996
  declare function resolveDomainPath(dataDir: string, id: string): string;
980
997
 
@@ -1150,6 +1167,7 @@ interface InitOptions {
1150
1167
  includeExamples: boolean;
1151
1168
  force: boolean;
1152
1169
  dryRun: boolean;
1170
+ hooks?: boolean;
1153
1171
  }
1154
1172
  type CopyStatus = 'installed' | 'unchanged' | 'overwritten' | 'skipped';
1155
1173
  interface CopyRecord {
@@ -1202,7 +1220,23 @@ declare function runReport(options: ReportOptions, ctx: {
1202
1220
  */
1203
1221
  declare function resolveSessionDir(sessionsDir: string, sessionId: string): string;
1204
1222
 
1205
- declare function runList(type: string, cwd: string): Promise<void>;
1223
+ interface ListOptions {
1224
+ /** Knowledge only: keep entries carrying this domain (or `all`). */
1225
+ domain?: string;
1226
+ /** Knowledge only: keep entries carrying this tag. */
1227
+ tag?: string;
1228
+ /** Knowledge only: keep entries of this type. */
1229
+ type?: string;
1230
+ /** Knowledge only: print one entry's YAML file instead of the listing. */
1231
+ entry?: string;
1232
+ /** Knowledge only: print the release changelog instead of the listing. */
1233
+ changelog?: boolean;
1234
+ /** Knowledge only: print stats, releases and loading-strategy counts. */
1235
+ stats?: boolean;
1236
+ /** Knowledge only: read the knowledge base from this data directory. */
1237
+ data?: string;
1238
+ }
1239
+ declare function runList(type: string, cwd: string, options?: ListOptions, log?: (line: string) => void): Promise<void>;
1206
1240
  interface SessionRow {
1207
1241
  date: string;
1208
1242
  kind: string;
@@ -1226,5 +1260,19 @@ interface ValidateOptions {
1226
1260
  declare function runValidate(options: ValidateOptions, cwd: string): number;
1227
1261
 
1228
1262
  declare function runKb(mode: 'sync' | 'check', cwd: string): SyncResult;
1263
+ interface KbDigestOptions {
1264
+ domain?: string;
1265
+ tag?: string[];
1266
+ /** `--for <skill>`; commander stores it under the flag's own name. */
1267
+ for?: string;
1268
+ entry?: string;
1269
+ data?: string;
1270
+ maxLines?: number;
1271
+ }
1272
+ /**
1273
+ * Builds the digest a session loads instead of reading the manifest and the
1274
+ * release files whole. Returns the text; the action prints it.
1275
+ */
1276
+ declare function runKbDigest(options: KbDigestOptions, cwd: string): string;
1229
1277
 
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 };
1278
+ 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, type KbDigestOptions, KnowledgeChangelogSchema, type KnowledgeEntry, type KnowledgeEntryContent, KnowledgeEntryContentSchema, KnowledgeEntrySchema, type KnowledgeManifest, type KnowledgeManifestEntry, KnowledgeManifestEntrySchema, KnowledgeManifestSchema, type KnowledgeManifestStats, KnowledgeManifestStatsSchema, KnowledgeReleaseSchema, 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, computeStats, containsSecrets, csvEscape, extractCoverage, extractListSection, extractReportMeta, generateHtmlReport, generateJiraExport, generateJsonReport, generateMarkdownSummary, getPackageRoot, getPackageVersion, hasConfidentialityHeader, listReleaseDirs, loadSessionForOutput, mergeGitignore, 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 };