Skip to content

feat(config): /inspire-config replaces /inspire-bootstrap, with a shipped default (B1) - #154

Open
QuimBallester wants to merge 4 commits into
release/2026-11-19from
QuimBallester/B1-config-replaces-booststrap
Open

QuimBallester wants to merge 4 commits into
release/2026-11-19from
QuimBallester/B1-config-replaces-booststrap

Conversation

@QuimBallester

@QuimBallester QuimBallester commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Closes B1-config-replaces-bootstrap · bumps the release to 0.21.0

What changes

/inspire-bootstrap is retired. /inspire-config becomes the project's whole configuration, and INSPIRE ships a default for everything it asks, so a project authors specs before anyone answers a technical question.

  • The spec config, .inspire/config.json: source_root, prototype_root, output_language. /inspire:init writes it with the defaults. Every skill, validator and hook reads it first, and falls back to stack.md's and project.md's frontmatter for a project installed before.
  • /inspire:init no longer asks for the product roots: with code at the repository root it writes . and none, and shows them in its plan. It asks whether to run the wizard afterwards; declining is a complete install.
  • /inspire:update builds the config from what stack.md and project.md already declare, asks nothing, edits no KB file, and deletes the unedited inspire-bootstrap skill.
  • The wizard (/inspire-config init) marks every question product or technical, asks the target before the stack, and lets every technical question keep its default.
  • Seeds: a seed names its profiles, image and layout. The shipped stack.md is the web seed (React and NestJS, node:24.22.1-trixie). On a seed, /inspire-config emanate asks no image question.
  • A seed carries a starter project, and INSPIRE lays it. New payload class base/seeds/ → .inspire/seeds/. The web starter is the Factory's react-nestjs-npm template, with the escape-hatch lint rules the nestjs stack skill gates added. .inspire/bin/scaffold.sh <seed> copies it under the source root of a repository with no code, refuses one that has any, and replaces no file of the project's. /inspire:init runs it when the operator keeps the defaults (--seed web), /inspire-config stack when the operator takes the seed. A described stack gets a minimal application from the interview.
  • The live design system moves to /inspire-screens design-system, and trust.sh maps design-system.md to that skill.
  • No shipped default names OpenBIMS.

Decisions taken to schedule the ticket

The ticket said its config shape was open. These were settled before the work, and its close note records them:

Question Decision
Shape of the spec config The shipped one: emanate.yml stays the Factory's file; config.json holds the two roots and the language. toolchains, the compose environment and config-check are withdrawn
Plugin skill or project skill The project skill /inspire-config grows; no /inspire:config
Identity, theme, design system Identity and theme in Config, as product questions; the design system in /inspire-screens
Scope Every acceptance criterion in one PR. The config-check criterion is marked withdrawn, not done

Renamed for operators

Was Is
/inspire-bootstrap init · language · stack · theme · review the same subcommand of /inspire-config
/inspire-bootstrap readme /inspire-config identity
/inspire-bootstrap design-system [backfill] /inspire-screens design-system [backfill]
/inspire-config init (write emanate.yml) /inspire-config emanate

Needs work outside this repository

  • INSPIRE Factory: the scaffold can leave the run. This is what the Factory's 091-remove-scaffold waits on. A project on the web seed, or on a described stack, now gets its starter from INSPIRE. The removal should refuse a run whose source root is empty and name /inspire-config stack.
  • INSPIRE Factory: the roots moved. The roots moved out of stack.md's frontmatter. If the Factory's deriver reads source_root there, a project installed on 0.21.0 with source_root: . is read as source until it reads .inspire/config.json first (derived-contract.md states the order). emanate.yml carries the root literally and is not affected. No Factory ticket is filed yet.
  • The manual (Genomcore/inspire-docs) still describes /inspire-bootstrap and init's root question.

Not built

The Factory's second template (react-fastapi-uv) as a seed, since INSPIRE ships no FastAPI stack skill; a monorepo seed, technology versions as config keys, an OpenAPI starter, and a seed for native mobile. The close note lists them; no ticket was filed for them.

Release

First PR into release/2026-11-19 that changes the runtime: both manifests go to 0.21.0, plugin/manifests/0.21.0.json is generated from the commit before it, and CHANGELOG.md has the 0.21.0 section. 0.20.0 was published while this was in progress, so the branch was redone on top of it.

Tests

bash plugin/test/run.sh: 116 files pass, 1 fails. The failure is plugin/test/visor/01-graph-plugin.sh ("an unreachable registry with a cold npm cache exits 3": got 1). It fails the same way on a clean checkout without this change.

New: materialize/13-spec-config.sh (defaults, flags, update keeps values, the migration from frontmatter, a broken config, the language guard), hooks/03-session-start-language.sh (the hook, prose-style.sh and _lib.sh read the config first), upgrade/28-bootstrap-retired.sh (a v0.19.0 project upgrades with nothing asked), skills/02-config-seeds.sh (every seed names a pinned image, and the table equals seed.json; the wizard's marks and order), materialize/14-seeds-class.sh (the class, every refusal of scaffold.sh, --seed, an update keeping an edited seed).

The starter is checked for real in 14-seeds-class.sh when npm and its registry are reachable, and skipped otherwise: npm ci from its lockfile, then test, test:e2e, typecheck, lint, build and the format check pass, the three escape-hatch rules fire on a file that breaks them, and profile-gates-installed.sh reports no gate missing. It ran here, and passed.

Two existing tests changed for the new class: upgrade/04-layout-signatures.sh expects seeds in the 0.3 map, and materialize/12-visor-class.sh no longer counts a seed's lockfile as visor source.

🤖 Generated with Claude Code

@github-actions
github-actions Bot changed the base branch from release/2026-11-18 to release/2026-11-19 November 19, 2026 09:09
@github-actions

Copy link
Copy Markdown
Contributor

Reapuntada de release/2026-11-18 a release/2026-11-19, la release abierta. A main solo se llega desde release/, hotfix/ o docs/.

@QuimBallester
QuimBallester force-pushed the QuimBallester/B1-config-replaces-booststrap branch from b46aba6 to 1545453 Compare November 19, 2026 09:47
QuimBallester and others added 4 commits November 19, 2026 10:48
…pped default (B1)

The spec config .inspire/config.json holds source_root, prototype_root and
output_language. /inspire:init writes it with the defaults and offers the
wizard; /inspire:update builds it from stack.md's and project.md's
frontmatter for a project installed before, and asks nothing.

/inspire-config grows into the project's whole configuration: a wizard that
marks every question product or technical, asks the target before the stack,
and lets a technical question keep its default; seeds that name their image;
and the emanate flow, which was its init. The live design system moves to
/inspire-screens design-system. /inspire-bootstrap is retired.

Closes B1-config-replaces-bootstrap.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
The seeds payload class, base/seeds/ → .inspire/seeds/: seed.json and files/.
The web starter is the Factory's react-nestjs-npm template with the escape-hatch
rules the nestjs stack skill gates. .inspire/bin/scaffold.sh lays a seed under
the source root of a repository with no code, refuses one with code, and
replaces no file of the project's. /inspire:init runs it when the operator keeps
the defaults (--seed), and /inspire-config stack when the operator takes the
seed. A described stack gets a minimal application from the interview.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@QuimBallester
QuimBallester force-pushed the QuimBallester/B1-config-replaces-booststrap branch from 1545453 to b638d5b Compare November 19, 2026 09:54

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant