Skip to content

Add iids-portfolio domain (lifecycle taxonomy from AISPEG ADR 0001) - #13

Merged
ProfessorPolymorphic merged 1 commit into
mainfrom
add-iids-portfolio-domain
May 3, 2026
Merged

Add iids-portfolio domain (lifecycle taxonomy from AISPEG ADR 0001)#13
ProfessorPolymorphic merged 1 commit into
mainfrom
add-iids-portfolio-domain

Conversation

@ProfessorPolymorphic

Copy link
Copy Markdown
Contributor

Summary

Registers the IIDS Portfolio site's controlled vocabularies under a new `iids-portfolio` domain. This is step 5 of the lifecycle-taxonomy rollout in ui-insight/AISPEG; the rules being recorded here are spec'd in ADR 0001 and enforced in code by `lib/portfolio-verification.ts`.

Once this is merged, AISPEG bumps its `vendor/data-governance` submodule pointer and the drift workflow starts policing these vocabularies alongside the existing audit / openera / processmapping / communications / research-admin / shared domains.

What lands

One new file: `vocabularies/iids-portfolio/allowed_values.json` with six vocabulary groups:

Group Cardinality Verification_Rule field
`InterventionStatus` 10 Yes — per-status measurable rule from ADR table
`PublicStage` 5 Yes — describes the rollup mapping
`ProductionScope` 3 No — granularity tag, not a status
`Visibility` 3 No
`AI4RARelationship` 5 No
`WorkCategory` 8 No

Schema extension: `Verification_Rule`

This adds a per-value `Verification_Rule` string field, currently scoped to the `iids-portfolio` domain (only `InterventionStatus` and `PublicStage` carry meaningful values). The field is additive — other domains' `allowed_values.json` don't include it, and consumers (like the AISPEG catalog builder) that don't yet read it simply ignore it. Adopting it for the existing four domains can happen later if/when those vocabularies grow verification rules of their own.

Test plan

  • JSON validates (six `value_groups`, all required fields present)
  • Drift workflow doesn't false-positive on the new domain
  • AISPEG-side regeneration (`npm run build:governance`) emits the new vocabularies into `lib/governance/vocabularies.ts`

🤖 Generated with Claude Code

…nums

Registers the IIDS Portfolio site's controlled vocabularies under a new
iids-portfolio domain. Lands the rules from ADR 0001 in AISPEG so the
drift workflow polices them alongside the existing audit / openera /
processmapping / communications / research-admin / shared domains.

Six vocabulary groups:
- InterventionStatus (10) — operational ladder for an intervention.
  Each value carries a Verification_Rule string describing the
  measurable rule enforced by lib/portfolio-verification.ts on every
  AISPEG PR.
- PublicStage (5) — stakeholder-facing rollup over InterventionStatus.
  Verification_Rule documents the rollup mapping.
- ProductionScope (3) — granularity of production reach (home-unit,
  institution-wide, external).
- Visibility (3) — public-site disclosure level.
- AI4RARelationship (5) — relationship to the UI+SUU NSF GRANTED
  partnership.
- WorkCategory (8) — by-problem axis for browsing the portfolio.

The new Verification_Rule field is a per-value extension scoped to
this domain. Other domains' allowed_values.json don't carry it; the
field is additive (consumers that don't expect it ignore it).

Source of truth and per-value rationale: see ADR 0001 in
https://github.com/ui-insight/AISPEG/blob/main/docs/adr/0001-product-lifecycle-taxonomy.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@ProfessorPolymorphic
ProfessorPolymorphic merged commit f6afe34 into main May 3, 2026
1 check passed
@ProfessorPolymorphic
ProfessorPolymorphic deleted the add-iids-portfolio-domain branch May 3, 2026 19:29
ProfessorPolymorphic added a commit to ui-insight/AISPEG that referenced this pull request May 3, 2026
Closes #168, closes #159. Step 5 of 5 in the lifecycle-taxonomy
rollout (ADR 0001). The IIDS Portfolio site's controlled
vocabularies are now registered upstream in
ui-insight/data-governance and policed by the drift workflow on
every PR.

What lands:
- Bumps vendor/data-governance submodule pointer to f6afe34
  (ui-insight/data-governance#13), which adds
  vocabularies/iids-portfolio/allowed_values.json — six vocab groups
  (InterventionStatus, PublicStage, ProductionScope, Visibility,
  AI4RARelationship, WorkCategory).
- Extends VocabularyValue with verificationRule?: string (ADR 0001
  per-value extension; populated only on InterventionStatus and
  PublicStage in the iids-portfolio domain).
- Updates scripts/build-governance-catalog.ts to read the new
  Verification_Rule field (with the snake_case fallback to match the
  existing field-handling pattern).
- Regenerates lib/governance/vocabularies.ts: 49 → 55 vocab groups
  (+6 iids-portfolio groups). Catalog table count unchanged
  (iids-portfolio is a vocabularies-only domain — no DB schema is
  tracked here).

Browser-verified at /standards/data-model/vocabularies — all 6
iids-portfolio groups linked and rendering with descriptions and
allowed values.

Refs ADR #164, schema PR #169, verifier PR #170, UI PR #171.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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