Qf Update

---
name: qf-update
description: >
  Refresh the file counts in .qualflare/test-state.md by re-globbing each
  framework row. Updates File count values and the Generated at timestamp
  in-place. Does not re-detect frameworks or change any other content.
  Use when the user runs /qf-update, asks to "refresh test counts", or after
  adding new test files without wanting to re-run full /qf-init.
argument-hint: "[framework-slug or package/path]"
allowed-tools: Read Edit Glob
---

## Step 1 — Read test state

Read `${CLAUDE_PROJECT_DIR}/.qualflare/test-state.md`.

If the file does not exist, tell the user:
> "No Qualflare state file found. Run `/qf-init` first to set up the integration."

Stop here — do not proceed without the state file.

Parse the following:
- **`## Project`** section: extract the current `Generated at:` timestamp.
- **`## Packages`** table: build a map of `path → identifier` from the `Path` and `Identifier` columns. The `Identifier` column must be preserved verbatim when the file is rewritten. If the `## Packages` table is absent, stop and tell the user to run `/qf-init` to refresh the state file.
- **`## Frameworks in use`** table: read every row's `Package`, `Slug`, `File count`, and `Top-level paths` columns. If the table has no `Package` column (legacy format), treat all rows as belonging to `(root)`.

Build an update queue — one item per table row:
```
[{ package, slug, storedCount, topLevelPaths }]
```

**Filter via `$ARGUMENTS`** (same tie-breaker as other qf commands: `/` = package path, no `/` = slug):
- `$ARGUMENTS` contains `/` → keep only items whose `package` starts with that prefix.
- `$ARGUMENTS` is a single word without `/` → keep only items whose `slug` matches.
- `$ARGUMENTS` contains both a `/`-token and a word → apply both filters.
- `$ARGUMENTS` is empty → process all rows.

If the filtered queue is empty, tell the user:
> "No matching frameworks found for `<$ARGUMENTS>`. Run `/qf-state` to see available packages and slugs."

Stop here.

---

## Step 2 — Re-glob live file counts

Read the glob patterns from `${CLAUDE_PLUGIN_ROOT}/skills/qf-init/references/framework-slugs.md`. Locate the "Test-File Globs Per Slug" table and extract the patterns for each slug in the queue. Drop from the queue any slug whose cell is `*(skip counting)*` — it has no test-file glob, and its stored count is left as is.

For each item in the queue, run Glob using each of that slug's patterns, scoped to the `Top-level paths` from the row. Exclude results under `node_modules/`, `vendor/`, `dist/`, `build/`, `.next/`, `.git/`, `__pycache__/`.

Sum the unique matches across all patterns for the slug. This is `liveCount`.

Record for each item: `{ package, slug, storedCount, liveCount, changed: liveCount !== storedCount }`.

---

## Step 3 — Apply updates to test-state.md

If **no items changed** (`changed === false` for all), tell the user:
> "File counts are already up to date — no changes needed."

Stop here.

For each item where `changed === true`, use the **Edit** tool to update its row in the `## Frameworks in use` table. Use the **exact raw line bytes read from the file in Step 1** as the `old_string` — do not reconstruct the row from parsed column values, as whitespace or path content may differ. Replace only the `File count` value in that row.

Example — if the row was:
```
| packages/web | jest | TypeScript | 42 | packages/web/src/**/*.test.ts |
```
and the live count is `47`, replace with:
```
| packages/web | jest | TypeScript | 47 | packages/web/src/**/*.test.ts |
```

Before making any edits, compute `newTimestamp` = current date and time in ISO 8601 format (e.g., `2026-04-21T10:30:00Z`). Use this single value for both the file edit and the Step 4 summary — do not recompute "now" a second time.

After updating all changed rows, also update the `Generated at:` line in the `## Project` section to `newTimestamp`.

---

## Step 4 — Print summary

```
Updated test-state.md file counts:

  jest (packages/web)         42 → 47  ✅
  playwright (packages/web)   18 → 18  (no change)
  golang (packages/api)       12 → 15  ✅

2 of 3 frameworks updated. Generated at: 2026-04-21T10:30:00Z
```

For single-package projects, omit the `(package)` suffix:
```
Updated test-state.md file counts:

  jest         42 → 47  ✅
  playwright   18 → 18  (no change)

1 of 2 frameworks updated. Generated at: 2026-04-21T10:30:00Z
```

If $ARGUMENTS scoped the run to a subset, note it:
```
Updated test-state.md file counts (jest only):

  jest   42 → 47  ✅

1 of 1 frameworks updated.
```

Always end with:
> "Run `/qf-doctor` to verify the full setup, or `/qf-run` to execute your tests."