Project inception — decide what a new project inherits (milestone 297) #124

Merged

bvandeusen merged 8 commits from dev into main 2026-08-21 22:16:33 -04:00

Conversation 0 Commits 8 Files Changed 32

+1515 -45

bvandeusen commented 2026-08-21 22:16:24 -04:00

Owner

Copy Link

Copy Source

A project's inheritance becomes a decision, not a default (milestone 297, concept #2864).

• Record — projects.inception JSON (migration 0085; legacy backfill stamps existing projects inherit-all so only new projects are asked); project_rulebook_exclusions (a project's opt-out of a whole always-on rulebook). Backup v10.
• Rules — exclusions are total: list_always_on_rules(project_id), the subscription-derived set, rules_payload.excluded_always_on (7th key), the SessionStart block for a bound project; exclude_/include_always_on_rulebook tools + REST.
• Service — inception.decide() validates every target before any effect, then applies (exclude, subscribe, design system, standard Systems seed) and writes the record last; current_defaults(); STANDARD_SYSTEMS moves to services/systems (the bootstrap ask names the same list).
• Doors — create_project(...) takes the inception args; decide_project_inception; enter_project carries an inception ask for the owner of an undecided project; REST POST /api/projects with inception, POST …/<id>/inception, GET …/<id>/inception/defaults; _INSTRUCTIONS (kept under the 2k fold).
• UI — New-project modal step 2, InceptionCard on the project page, Rules tab shows excluded always-on rulebooks.
• Docs — using-scribe skill section, plugin 0.1.38, api-reference, README.

CI green on dev (run 4202). Migration 0085 runs on deploy.

🤖 Generated with Claude Code

A project's inheritance becomes a decision, not a default (milestone 297, concept #2864). - **Record** — `projects.inception` JSON (migration 0085; legacy backfill stamps existing projects inherit-all so only new projects are asked); `project_rulebook_exclusions` (a project's opt-out of a whole always-on rulebook). Backup v10. - **Rules** — exclusions are total: `list_always_on_rules(project_id)`, the subscription-derived set, `rules_payload.excluded_always_on` (7th key), the SessionStart block for a bound project; `exclude_/include_always_on_rulebook` tools + REST. - **Service** — `inception.decide()` validates every target before any effect, then applies (exclude, subscribe, design system, standard Systems seed) and writes the record last; `current_defaults()`; `STANDARD_SYSTEMS` moves to `services/systems` (the bootstrap ask names the same list). - **Doors** — `create_project(...)` takes the inception args; `decide_project_inception`; `enter_project` carries an `inception` ask for the owner of an undecided project; REST `POST /api/projects` with `inception`, `POST …/<id>/inception`, `GET …/<id>/inception/defaults`; `_INSTRUCTIONS` (kept under the 2k fold). - **UI** — New-project modal step 2, `InceptionCard` on the project page, Rules tab shows excluded always-on rulebooks. - **Docs** — using-scribe skill section, plugin 0.1.38, api-reference, README. CI green on dev (run 4202). Migration 0085 runs on deploy. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

bvandeusen added 8 commits 2026-08-21 22:16:24 -04:00

feat(inception): projects.inception record + project_rulebook_exclusions — migration 0085 with legacy backfill; backup v10 (#2879, milestone 297 step 1) ... e9b8f525c8

A project's inheritance becomes a decision, not a default (milestone 297).
- projects.inception (JSONB, NULL = undecided): {decided_at, decided_by, via
  mcp|ui|legacy, choices {exclude_always_on_rulebooks, subscribe_rulebooks,
  design_system_id, seed_systems}}; on to_dict.
- project_rulebook_exclusions: a project's opt-out of a whole always-on
  rulebook — the sibling of the rule/topic suppressions, CASCADE both ways.
- services/inception.py (first cut): the vocabulary, validate_inception
  (pure, all-or-nothing), normalize_choices, is_decided. Effects come in
  step 3.
- Migration 0085 backfills every existing project via="legacy" with its
  current standing (no exclusions, its subscriptions, its design_system_id,
  no seed) so the ask fires only for projects created after this ships.
- Backup v10: rulebook_exclusions section; project rows carry inception and
  design_system_id, restored in a post-pass once rulebooks/design systems are
  mapped (design_system_id was not restored before — fixed in passing).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

feat(inception): always-on exclusions reach every rule surface — list_always_on_rules(project_id), get_applicable_rules, rules_payload.excluded_always_on, session context, exclude/include tools (#2880, milestone 297 step 2) ... ff5f6438c4

A project that opted out of an always-on rulebook at inception must not see
it anywhere: list_always_on_rules(project_id=) and the subscription-derived
set skip it (an exclusion is total), get_applicable_rules / rules_payload
carry `excluded_always_on` as the seventh key so the departure is visible
wherever the rules are, and the SessionStart block built for a bound project
names it ("Excluded for this project by its inception decision …"). MCP:
list_always_on_rules takes project_id; exclude_always_on_rulebook /
include_always_on_rulebook mirror suppress/unsuppress (owner-only; the
rulebook must be always_on — subscribed rulebooks are left by unsubscribing).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

feat(inception): services/inception.decide() + current_defaults(); the standard Systems vocabulary moves to the service and seeds at inception (#2881, milestone 297 step 3) ... 34734bf84a

- inception.decide(user, project, choices=, via=): owner-only; validates the
  choices (pure) and every target (owned rulebook / always-on for an
  exclusion / readable design system) BEFORE any effect; then, each
  idempotent: exclude always-on rulebooks, subscribe rulebooks, point the
  design system (None = explicitly none), seed the standard Systems if asked
  and the project has none; writes projects.inception LAST. Re-deciding is
  additive for exclusions/subscriptions, replaces the design system, never
  re-seeds.
- inception.current_defaults(): what binds if nobody decides — the ask's
  payload (always-on / other rulebooks, standing exclusions + subscriptions,
  design system + the choices, Systems count).
- services/systems.STANDARD_SYSTEMS (name + generic charter) + seed_standard_systems();
  mcp/tools/systems names the same list in the bootstrap ask — one vocabulary.
- Integration tests: effects land and the record says why; bad targets apply
  nothing; outsiders cannot decide.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

test: mocked-session rule tests stub the always-on exclusions lookup; tool count 24 (#2880) ... 227aef3dbf

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

feat(inception): the doors — create_project/decide_project_inception take the decision, enter_project asks until decided, REST inception endpoints, _INSTRUCTIONS (#2882, milestone 297 step 4) ... c7a58bb610

- MCP create_project(..., exclude_always_on_rulebooks, subscribe_rulebooks,
  design_system_id (0 unstated / -1 none / n), seed_systems): any inception
  arg → inception.decide(via="mcp") after the create; none → undecided with
  an inception_hint. New decide_project_inception(project_id, …) records or
  re-records; nothing given = an inherit-all decision, stated.
- enter_project carries `inception` ONLY for the caller's own, undecided
  project: inception_ask() = the project's current defaults + what to ask the
  operator once + the exact call (the #2683 ask shape). Absent otherwise.
- REST: POST /api/projects accepts `inception` (validated before the create);
  POST /api/projects/<id>/inception decides/re-decides; GET …/inception/defaults
  is the card's payload; GET project already carries inception via to_dict.
- _INSTRUCTIONS: ORIENT names the ask; START a project names the questions —
  never create a project bare by default (product behaviour, P#119).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

feat(inception): UI — New-project modal step 2, InceptionCard on the project page, Rules tab shows excluded always-on rulebooks; REST exclusion routes (#2883, milestone 297 step 5) ... 00c7badc3f

- components/InceptionCard.vue: the one form, two homes — mode="create" in
  the New-project modal's second step (emits the choices; the create carries
  `inception`), mode="decide" on ProjectView for the owner of an undecided
  project (loads that project's defaults, records the decision). Always-on
  rulebooks listed checked (uncheck = exclude), others unchecked (check =
  subscribe), design system select, seed-Systems toggle (disabled once the
  project has Systems). Tokens only; modal canon (#2855); .btn-* canon.
- ProjectView: the card while undecided, one "Inheritance decided <date> via
  … · …" line after; onDecided refreshes the project.
- ProjectRulesTab: "Excluded always-on rulebooks" section with include-back.
- api/inception.ts (types, fetchInceptionDefaults, decideInception);
  api/rulebooks.ts: ApplicableRules.excluded_always_on, exclude/include
  wrappers; REST POST/DELETE /api/projects/<id>/exclusions/rulebooks/<rb>.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

fix(mcp): _INSTRUCTIONS back under the 2k fold — the inception line is one clause, detail lives in the tool docstrings (#2882) ... 10c63f49d8

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

docs(inception): using-scribe skill teaches the inception questions; plugin 0.1.38; api-reference + README (#2884, milestone 297 step 6) ... dc2f32cc6f

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

bvandeusen merged commit c0caf7d23a into main 2026-08-21 22:16:33 -04:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

No items

No labels

Milestone

No items

No Milestone

Projects

Clear projects

No projects

Assignees

Clear assignees

renovate-bot bvandeusen

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: bvandeusen/FabledScribe#124