Skip to content
Back to skills

V1.0.11

ASecurity

Upgrade a project to forge v1.0.11. More generated files merge with plain git. The read-only and dashboard grants (db/grants/*_gen.sql), the config module (deploy/kcl/config_gen.k) and the scenario handler map (src/mocks/scenario-rpcs_gen.ts) certify each table, config block and service separately, the scaffold ledger .forge/scaffolded.json becomes one entry file per path under .forge/scaffolded/, and the mock-fixture fingerprint leaves the committed fixture-manifest_gen.ts for a gitignored m...

  • 10 stars
  • 0 votes
  • 0 copies
  • 1 view
  • Added November 13, 2026
developmentgosqlgitfrontend

Works with

  • cli

Security analysis

A100/100

Scanned November 13, 2026

npx -y skills add reliant-labs/forge --skill v1.0.11 --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of V1.0.11?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for V1.0.11
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/reliant-labs-v1-0-11/badge)](https://www.skillsdirectory.com/skills/reliant-labs-v1-0-11)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: v1.0.11
description: Upgrade a project to forge v1.0.11. More generated files merge with plain git. The read-only and dashboard grants (db/grants/*_gen.sql), the config module (deploy/kcl/config_gen.k) and the scenario handler map (src/mocks/scenario-rpcs_gen.ts) certify each table, config block and service separately, the scaffold ledger .forge/scaffolded.json becomes one entry file per path under .forge/scaffolded/, and the mock-fixture fingerprint leaves the committed fixture-manifest_gen.ts for a gitignored marker. Use when the project commits any of those files.
version: v1.0.11
detection: test -f .forge/scaffolded.json -o -f db/grants/readonly_gen.sql -o -f deploy/kcl/config_gen.k && exit 0; ls frontends/*/src/mocks/scenario-rpcs_gen.ts frontends/*/src/mocks/fixture-manifest_gen.ts >/dev/null 2>&1 && exit 0; exit 1
---

# Upgrading to v1.0.11

The first `forge generate` on v1.0.11 migrates everything below. Commit what it writes in one change.

## 1. Grants, config module and scenario handler map certify each part

Each of these files gathers independent parts into one file, and each carried ONE `forge:hash` over all of it. Two pull requests that changed different parts (two tables' columns, two config blocks, two services' rpcs) both rewrote that one line, and git, including GitHub's server-side merge, which runs no merge driver, reported a conflict. Over the week to 2026-10-30, `readonly_gen.sql` and `config_gen.k` conflicted in 34 pull requests across reliant and control-plane, every time on that line alone.

Each part now begins with its own `forge:section forge:hash=…` comment, which certifies that part. The header hash covers only the shared preamble. A file still counts as forge's untouched render only when every hash verifies, so hand-edit detection is unchanged. Two pull requests that change different parts now merge into exactly what `forge generate` writes for both.

- **`db/grants/readonly_gen.sql`, `db/grants/dashboard_gen.sql`:** one section per table. The table's columns list starts with a constant first row, so every table's row starts with its own comma, and adding the last table never rewrites the row before it. The withheld-column notes (`forge:secret`, and credential-shaped columns nobody decided) moved from the end of the file into each table's section. The SQL the migrator applies is unchanged in effect.
- **`deploy/kcl/config_gen.k`:** one section per config block schema, per root schema, per env-projection lambda and per process selector. Inside each lambda, one section per config block's env entries.
- **`src/mocks/scenario-rpcs_gen.ts`:** `ScenarioRpcHandlers` is an intersection of one object type per service, each its own section. Every request and response type is imported inline (`import("@/gen/…").Name`), so the shared `import type` block is gone, and so are the `<module>_<Name>` aliases for message names two services share. Scenario files that use `ScenarioRpcHandlers` need no change.

### Still a conflict

Two pull requests that change the SAME table, config block or service still conflict there, because both changed that part. So do two that each add a new one between the same two neighbours. `forge generate` on the merged inputs resolves either.

## 2. `.forge/scaffolded.json` becomes `.forge/scaffolded/`

**Use when** the project commits `.forge/scaffolded.json`.

**What changed.** The scaffold-once birth ledger, the record that keeps a deleted scaffold deleted, was one sorted file. Every branch that scaffolds anything records births in it, so two branches' births were neighbouring insertions there, and git conflicted. Each path's record is now its own file, at the path under `.forge/scaffolded/` with `.json` appended (`.forge/scaffolded/internal/app/compose.go.json`). It holds `{}` for an ordinary birth, or the decline reason, birth hash or reported-absent mark the path carries. The birth timestamp is gone: nothing read it, and it made two branches scaffolding the same path disagree. Two branches now conflict there only over the same path.

**What generate does.** It reads the old file, writes one entry per path, deletes `.forge/scaffolded.json`, and rewrites `.gitignore`'s `!.forge/scaffolded.json` to `!.forge/scaffolded/`. The line is rewritten only when it is exactly forge's own; otherwise re-include `.forge/scaffolded/` yourself. In a `.gitattributes` copied from forge's scaffold, replace `.forge/scaffolded.json merge=forge-generated` with `.forge/scaffolded/** merge=forge-generated`.

## 3. The mock-fixture fingerprint is no longer committed

**Use when** a frontend has `src/mocks/fixture-manifest_gen.ts`.

**What changed.** `fixture-manifest_gen.ts` recorded `SEED_FINGERPRINT`, one digest of every migration and `db/seeds/vocab.yaml`. Every branch that added a migration rewrote that line, so any two such branches conflicted on it (control-plane's manifest did, in 45 merges in the week to 2026-10-30). A per-migration list would not help, because two new migrations always sort to the same place. The fingerprint is tooling state that no compiler needs, so, like the descriptor (v1.0.10), it leaves git. `forge generate` now writes it to a marker, `.forge/fixtures/<frontend>/generated-from.json`, which every forge project already ignores. The marker also records the sha256 of each generated file it wrote beside the fixtures. The committed manifest keeps only constants (`PROJECT_ROOT_FROM_FRONTEND`, `FIXTURE_MARKER`), so a migration no longer changes it. `SEED_FINGERPRINT`, `SEED_CONFIG_FINGERPRINT` and `SEED_FINGERPRINT_FILES` are gone; the marker carries the same values as `seed_fingerprint`, `seed_config_fingerprint` and `seed_fingerprint_files`.

**What the freshness guard does now.** `fixture-freshness_gen.test.ts` still recomputes the digest from the files on disk.
- When the marker describes the fixtures on disk, a changed digest **fails** with the fix, as before.
- With no marker (a fresh clone, CI), or with fixtures that differ from the ones it describes (pulled or checked out since), the guard **skips**, naming `forge generate`. Committed fixtures are checked against their inputs by `forge ci verify-generated`.

**What to do.** Nothing by hand, unless your own code imports one of the removed constants. In that case, read the marker instead.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in development →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.