generated from coulomb/repo-seed
Retire capability: Haskell/IHP build-chain problems, superseded by core-hub
Some checks are pending
Build and Deploy / build-push-deploy (push) Waiting to run
Some checks are pending
Build and Deploy / build-push-deploy (push) Waiting to run
Maturity reassessment (2026-07-07): discovery D3->D5 to honestly reflect Phases 0-9 being complete (real controllers, tests, versioned /api/v2 with OpenAPI/OAuth/SDKs/webhooks) -- the initial D3 undersold real depth. Status set to deprecated. Availability deliberately held at A1: the Haskell/IHP build chain is the specific reason for retirement, not raised despite the deep feature implementation. Completeness raised to C3 (nine phases delivered); the one broken expectation is build-chain reliability itself. Reliability held at R0 -- retirement is negative evidence, not a promotion. relations.related_to now points at capability.infotech.core-hub, the contract-first Python/FastAPI/Postgres rebuild (see core-hub/SCOPE.md), which plans Inter-Hub /api/v2 compatibility and a migration path. Requested by Bernd as a follow-up to the reuse-surface REUSE-WP-0017 coverage sweep. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
@@ -3,49 +3,67 @@ id: capability.infotech.interaction-hub-framework
|
|||||||
name: Interaction Hub Framework (IHF)
|
name: Interaction Hub Framework (IHF)
|
||||||
summary: Specification and reference implementation of a governed, observable interaction substrate connecting
|
summary: Specification and reference implementation of a governed, observable interaction substrate connecting
|
||||||
rendered UI widgets to structured feedback, requirements, decisions, implementation changes, and observed
|
rendered UI widgets to structured feedback, requirements, decisions, implementation changes, and observed
|
||||||
outcomes.
|
outcomes. Retired (Haskell/IHP build-chain problems); superseded by core-hub.
|
||||||
owner: inter-hub
|
owner: inter-hub
|
||||||
status: draft
|
status: deprecated
|
||||||
domain: infotech
|
domain: infotech
|
||||||
tags:
|
tags:
|
||||||
- interaction
|
- interaction
|
||||||
- governance
|
- governance
|
||||||
- ihp
|
- ihp
|
||||||
- haskell
|
- haskell
|
||||||
|
- retired
|
||||||
maturity:
|
maturity:
|
||||||
discovery:
|
discovery:
|
||||||
current: D3
|
current: D5
|
||||||
target: D5
|
target: D5
|
||||||
confidence: medium
|
confidence: high
|
||||||
rationale: 'SCOPE.md documents the full traceability chain (widget -> interaction -> feedback -> requirement
|
rationale: 'Reassessed 2026-07-07 against the actual implementation, not just SCOPE.md prose: Phases 0-9
|
||||||
-> decision -> implementation -> outcome) with explicit in-scope/out-of-scope lists; specs/ and
|
are complete per SCOPE.md''s own per-phase log, with real Web/Controller/ modules (governance, requirements,
|
||||||
contracts/ dirs back this up. Note: README.md is a stale repo-seed template leftover, not representative
|
hub capability manifests, federated policy overlays, deployment records, agent registrations, webhooks,
|
||||||
— SCOPE.md is authoritative.'
|
and more), a Test/ suite, and a versioned external API (/api/v2) with OpenAPI, OAuth client credentials,
|
||||||
|
generated SDKs, and rate limiting. This was a substantial working reference implementation, not a paper
|
||||||
|
spec -- discovery confidence raised from medium to high and D3 to D5 accordingly. Target stays D5: no
|
||||||
|
further discovery work is planned now that the repo is retired.'
|
||||||
availability:
|
availability:
|
||||||
current: A1
|
current: A1
|
||||||
target: A3
|
target: A1
|
||||||
confidence: low
|
confidence: high
|
||||||
rationale: Haskell/IHP application (App.cabal, Main.hs, Web/Application dirs) with a `.gitea/workflows/deploy.yaml`;
|
rationale: 'Deliberately NOT raised despite the deep implementation: the Haskell/IHP build chain is the
|
||||||
runnable/deployable but availability confidence is low pending direct verification of a working
|
specific reason this capability was retired (2026-07-07, owner decision) in favor of core-hub on a more
|
||||||
build in this sweep.
|
convenient Python/FastAPI/Postgres stack. Feature completeness and build/deploy reliability are different
|
||||||
|
axes -- this one stayed low precisely because the latter broke down. Target frozen at A1; no further
|
||||||
|
availability investment is planned.'
|
||||||
external_evidence:
|
external_evidence:
|
||||||
completeness:
|
completeness:
|
||||||
level: C1
|
level: C3
|
||||||
confidence: low
|
confidence: medium
|
||||||
basis: scope_vs_intent_and_consumer_expectations
|
basis: scope_vs_intent_and_consumer_expectations
|
||||||
satisfied_expectations:
|
satisfied_expectations:
|
||||||
- widget identity/lifecycle governance scope documented
|
- widget identity/lifecycle governance implemented (Phase 1)
|
||||||
- interaction event capture and annotation scope documented
|
- structured feedback, triage, and requirement distillation implemented (Phases 2-3)
|
||||||
broken_expectations: []
|
- governance ledger and decision records implemented (Phase 3)
|
||||||
|
- outcome signals and regression detection implemented (Phase 4)
|
||||||
|
- agent-assisted proposals and review implemented (Phase 5)
|
||||||
|
- cross-framework adapter contracts (EnvelopeEmissionContract, WidgetAdapterSpec, React adapter) implemented (Phase 6)
|
||||||
|
- friction/health observability implemented (Phase 7)
|
||||||
|
- federated governance and delegated ownership implemented (Phase 8)
|
||||||
|
- versioned external API with OpenAPI, OAuth, SDKs, webhooks implemented (Phase 9)
|
||||||
|
broken_expectations:
|
||||||
|
- build chain reliability -- the reason for retirement; feature completeness did not translate into a
|
||||||
|
dependable build/deploy path
|
||||||
out_of_scope_expectations: []
|
out_of_scope_expectations: []
|
||||||
reliability:
|
reliability:
|
||||||
level: R0
|
level: R0
|
||||||
confidence: low
|
confidence: high
|
||||||
basis: consumer_quality_signals
|
basis: consumer_quality_signals
|
||||||
known_reliability_risks:
|
known_reliability_risks:
|
||||||
- README.md is stale/misleading (leftover repo-seed template text) — needs fixing regardless of registry
|
- 'RETIRED 2026-07-07: owner decision to retire this capability due to persistent Haskell/IHP build-chain
|
||||||
status
|
problems. This is itself the reliability evidence -- a substantial feature-complete implementation that
|
||||||
- availability not independently verified (build not run during this sweep)
|
could not be kept dependably buildable/deployable. Do not build new integrations against it.'
|
||||||
|
- successor is core-hub (capability.infotech.core-hub), a contract-first rebuild on Python/FastAPI/Postgres,
|
||||||
|
explicitly scoped to include Inter-Hub /api/v2 compatibility and a data-migration/cutover plan during
|
||||||
|
the transition (see core-hub/SCOPE.md)
|
||||||
discovery:
|
discovery:
|
||||||
intent: 'Make UI interaction observable and governable: connect every meaningful widget to structured
|
intent: 'Make UI interaction observable and governable: connect every meaningful widget to structured
|
||||||
feedback, distilled requirements, governance decisions, and observed post-change outcomes.'
|
feedback, distilled requirements, governance decisions, and observed post-change outcomes.'
|
||||||
@@ -55,42 +73,64 @@ discovery:
|
|||||||
- annotation/structured comment threads
|
- annotation/structured comment threads
|
||||||
- requirements distillation and governance ledger
|
- requirements distillation and governance ledger
|
||||||
- outcome observation
|
- outcome observation
|
||||||
|
- federated governance, delegated ownership, cross-hub policy overlays (Phase 8)
|
||||||
|
- versioned external API surface (Phase 9)
|
||||||
excludes:
|
excludes:
|
||||||
- hub-specific business domain concepts outside the interaction-governance substrate
|
- hub-specific business domain concepts outside the interaction-governance substrate
|
||||||
|
- new development -- retired; see core-hub for active work
|
||||||
assumptions: []
|
assumptions: []
|
||||||
use_cases: []
|
use_cases: []
|
||||||
research_memos: []
|
research_memos: []
|
||||||
availability:
|
availability:
|
||||||
current_level: A1
|
current_level: A1
|
||||||
target_level: A3
|
target_level: A1
|
||||||
current_artifacts:
|
current_artifacts:
|
||||||
- Haskell/IHP application
|
- Haskell/IHP application (retired, reference/historical only)
|
||||||
target_artifacts: []
|
target_artifacts: []
|
||||||
consumption_modes:
|
consumption_modes:
|
||||||
- application
|
- application
|
||||||
relations:
|
relations:
|
||||||
depends_on: []
|
depends_on: []
|
||||||
supports: []
|
supports: []
|
||||||
related_to: []
|
related_to:
|
||||||
|
- capability.infotech.core-hub
|
||||||
evidence:
|
evidence:
|
||||||
documentation:
|
documentation:
|
||||||
- SCOPE.md
|
- SCOPE.md
|
||||||
- specs/
|
- specs/InteractionHubFrameworkSpecification_v0.1.md
|
||||||
|
- specs/InteractionHubFrameworkSpecification_v0.2.md
|
||||||
- contracts/
|
- contracts/
|
||||||
tests:
|
tests:
|
||||||
- Test/
|
- Test/
|
||||||
consumer_feedback: []
|
consumer_feedback: []
|
||||||
bug_reports: []
|
bug_reports: []
|
||||||
incidents: []
|
incidents:
|
||||||
|
- Haskell/IHP build-chain instability led to full retirement of this capability (2026-07-07)
|
||||||
consumer_guidance:
|
consumer_guidance:
|
||||||
recommended_for:
|
recommended_for:
|
||||||
- hub-based systems wanting governed, traceable UI interaction
|
- historical reference and prior-art study for governed interaction substrates
|
||||||
|
- understanding requirements that core-hub's Inter-Hub /api/v2 compatibility layer must satisfy
|
||||||
not_recommended_for:
|
not_recommended_for:
|
||||||
- consumers needing a stable published API today (not yet independently verified in this sweep)
|
- any new integration or development -- retired; use core-hub instead
|
||||||
known_limitations:
|
known_limitations:
|
||||||
- README.md needs fixing (stale repo-seed leftover text); availability not independently build-verified
|
- 'Retired. Do not build against this. See capability.infotech.core-hub for the active successor (Python/FastAPI/Postgres,
|
||||||
this sweep
|
contract-first, includes an Inter-Hub /api/v2 compatibility and migration plan).'
|
||||||
promotion_history: []
|
promotion_history:
|
||||||
|
- date: "2026-07-07"
|
||||||
|
dimension: discovery
|
||||||
|
from: D3
|
||||||
|
to: D5
|
||||||
|
rationale: Reassessed against the actual Phases 0-9 implementation (controllers, tests, versioned API) rather
|
||||||
|
than SCOPE.md prose alone; the initial D3 undersold real discovery depth.
|
||||||
|
author: reuse-surface-coverage-review
|
||||||
|
- date: "2026-07-07"
|
||||||
|
dimension: reliability
|
||||||
|
from: R0
|
||||||
|
to: R0
|
||||||
|
rationale: Owner retired this capability due to persistent Haskell/IHP build-chain problems; status set
|
||||||
|
to deprecated, availability target frozen at A1, relations point at capability.infotech.core-hub as
|
||||||
|
successor. Reliability level held at R0 -- the retirement is negative evidence, not a promotion.
|
||||||
|
author: bernd
|
||||||
---
|
---
|
||||||
|
|
||||||
# Interaction Hub Framework (IHF)
|
# Interaction Hub Framework (IHF)
|
||||||
@@ -99,31 +139,36 @@ promotion_history: []
|
|||||||
|
|
||||||
`inter-hub` specifies and implements the Interaction Hub Framework (IHF): every meaningful UI widget becomes a governed interaction artifact with a full traceability chain from rendered widget through user interaction, structured feedback, requirement distillation, governance decision, implementation change, to observed outcome.
|
`inter-hub` specifies and implements the Interaction Hub Framework (IHF): every meaningful UI widget becomes a governed interaction artifact with a full traceability chain from rendered widget through user interaction, structured feedback, requirement distillation, governance decision, implementation change, to observed outcome.
|
||||||
|
|
||||||
|
**Retired 2026-07-07.** The Haskell/IHP implementation reached substantial
|
||||||
|
feature completeness (Phases 0-9) but suffered persistent build-chain
|
||||||
|
problems. The owner decided to retire this capability and rebuild the same
|
||||||
|
framework ambition on a more convenient technology stack: see
|
||||||
|
[`core-hub`](../core-hub/) (`capability.infotech.core-hub`), a
|
||||||
|
contract-first Python/FastAPI/Postgres rebuild that plans Inter-Hub
|
||||||
|
`/api/v2` compatibility and a migration path.
|
||||||
|
|
||||||
## Assessment notes
|
## Assessment notes
|
||||||
|
|
||||||
### Discovery
|
### Discovery
|
||||||
|
|
||||||
SCOPE.md documents the full traceability chain (widget -> interaction -> feedback -> requirement -> decision -> implementation -> outcome) with explicit in-scope/out-of-scope lists; specs/ and contracts/ dirs back this up. Note: README.md is a stale repo-seed template leftover, not representative — SCOPE.md is authoritative.
|
Reassessed 2026-07-07 against the actual implementation: Phases 0-9 complete per SCOPE.md's own per-phase log, with real `Web/Controller/` modules, a `Test/` suite, and a versioned external API. This was a substantial working reference implementation, not a paper spec — raised from D3 to D5.
|
||||||
|
|
||||||
### Availability
|
### Availability
|
||||||
|
|
||||||
Haskell/IHP application (App.cabal, Main.hs, Web/Application dirs) with a `.gitea/workflows/deploy.yaml`; runnable/deployable but availability confidence is low pending direct verification of a working build in this sweep.
|
Deliberately not raised: the Haskell/IHP build chain is the specific reason this capability was retired. Feature completeness and build/deploy reliability are different axes, and this one is exactly why the retirement happened.
|
||||||
|
|
||||||
### Completeness
|
### Completeness
|
||||||
|
|
||||||
First-pass honest assessment from the REUSE-WP-0017 coverage campaign
|
Nine implementation phases delivered against the original spec's traceability chain — genuinely high completeness on the feature axis (C3). The one broken expectation, build-chain reliability, is exactly what triggered retirement.
|
||||||
(reuse-surface). No external consumer feedback exists yet; levels reflect
|
|
||||||
scope-vs-intent documentation quality, not internal code quality.
|
|
||||||
|
|
||||||
### Reliability
|
### Reliability
|
||||||
|
|
||||||
No production consumer telemetry exists yet; reliability level is
|
Held at R0. The retirement itself is the reliability signal: a feature-complete implementation that could not be kept dependably buildable. This is documented as an incident, not glossed over.
|
||||||
intentionally conservative pending REUSE-WP-0019 reuse-telemetry evidence.
|
|
||||||
|
|
||||||
## Promotion checklist
|
## Promotion checklist
|
||||||
|
|
||||||
- [x] ID follows `capability.<domain>.<name>` pattern
|
- [x] ID follows `capability.<domain>.<name>` pattern
|
||||||
- [x] Maturity enums match `specs/CapabilityMaturityStandard.md`
|
- [x] Maturity enums match `specs/CapabilityMaturityStandard.md`
|
||||||
- [x] `external_evidence` is populated separately from `maturity`
|
- [x] `external_evidence` is populated separately from `maturity`
|
||||||
- [ ] Relations reference valid capability IDs (none yet)
|
- [x] Relations reference valid capability IDs (`capability.infotech.core-hub`)
|
||||||
- [x] Index entry added in `registry/indexes/capabilities.yaml`
|
- [x] Index entry added in `registry/indexes/capabilities.yaml`
|
||||||
|
|||||||
@@ -1,15 +1,15 @@
|
|||||||
version: 1
|
version: 1
|
||||||
updated: '2026-07-06'
|
updated: '2026-07-07'
|
||||||
domain: helix_forge
|
domain: helix_forge
|
||||||
capabilities:
|
capabilities:
|
||||||
- id: capability.infotech.interaction-hub-framework
|
- id: capability.infotech.interaction-hub-framework
|
||||||
name: Interaction Hub Framework (IHF)
|
name: Interaction Hub Framework (IHF)
|
||||||
summary: Specification and reference implementation of a governed, observable interaction substrate
|
summary: Specification and reference implementation of a governed, observable interaction substrate
|
||||||
connecting rendered UI widgets to structured feedback, requirements, decisions, implementation changes,
|
connecting rendered UI widgets to structured feedback, requirements, decisions, implementation changes,
|
||||||
and observed outcomes.
|
and observed outcomes. Retired (Haskell/IHP build-chain problems); superseded by core-hub.
|
||||||
vector: D3 / A1 / C1 / R0
|
vector: D5 / A1 / C3 / R0
|
||||||
domain: infotech
|
domain: infotech
|
||||||
status: draft
|
status: deprecated
|
||||||
owner: inter-hub
|
owner: inter-hub
|
||||||
path: registry/capabilities/capability.infotech.interaction-hub-framework.md
|
path: registry/capabilities/capability.infotech.interaction-hub-framework.md
|
||||||
tags:
|
tags:
|
||||||
@@ -17,5 +17,6 @@ capabilities:
|
|||||||
- governance
|
- governance
|
||||||
- ihp
|
- ihp
|
||||||
- haskell
|
- haskell
|
||||||
|
- retired
|
||||||
consumption_modes:
|
consumption_modes:
|
||||||
- application
|
- application
|
||||||
|
|||||||
Reference in New Issue
Block a user