@alistigo/features 0.2.4 → 0.2.6

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alistigo/features",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "license": "MIT",
   "author": {
     "name": "Mikael Labrut",

package/dist/tags.d.ts

@@ -11,17 +11,24 @@
  * Tag categories follow the `gherkin-features` skill: Milestone, Group,
  * Capability, Test type, Suite, Actor.
  */
-/** Which milestone a feature belongs to. Required — every Feature has exactly one. */
-export declare const MILESTONE_TAGS: readonly ["@m1", "@m2", "@m3", "@m4", "@v1"];
+/**
+ * Which milestone a feature belongs to. Required — every Feature has exactly one.
+ *
+ * `@platform` marks cross-cutting platform capabilities (e.g. the artifact plugin
+ * system) that are orthogonal to the numbered milestone sequence, rather than
+ * belonging to a specific numbered milestone.
+ */
+export declare const MILESTONE_TAGS: readonly ["@m1", "@m2", "@m3", "@m4", "@v1", "@platform"];
 export type MilestoneTag = (typeof MILESTONE_TAGS)[number];
 /**
  * Which feature group a feature belongs to. Required — every Feature has
  * exactly one. Mirrors the folder layout under `features/`.
  *
  * - `@core` — base list app (text elements, add, delete, persist)
- * - Plugin groups will be added as plugins land: `@todo`, `@checklist`, etc.
+ * - `@artifact-plugins` — artifact-lifecycle/infra plugins (Sentry, PostHog)
+ * - Domain plugin groups will be added as they land: `@todo`, `@checklist`, etc.
  */
-export declare const GROUP_TAGS: readonly ["@core"];
+export declare const GROUP_TAGS: readonly ["@core", "@artifact-plugins"];
 export type GroupTag = (typeof GROUP_TAGS)[number];
 /** What capability the feature exercises. Required — at least one. */
 export declare const CAPABILITY_TAGS: readonly ["@capability:list", "@capability:element", "@capability:persistence", "@capability:loading", "@capability:export", "@capability:host-protocol", "@capability:plugins"];

package/dist/tags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../src/tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,sFAAsF;AACtF,eAAO,MAAM,cAAc,8CAA+C,CAAC;AAC3E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,oBAAqB,CAAC;AAC7C,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,sEAAsE;AACtE,eAAO,MAAM,eAAe,kLAQlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,+CAA+C;AAC/C,eAAO,MAAM,cAAc,uDAAwD,CAAC;AACpF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,0DAA0D;AAC1D,eAAO,MAAM,UAAU,6CAA8C,CAAC;AACtE,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,2CAA2C;AAC3C,eAAO,MAAM,UAAU,sDAAuD,CAAC;AAC/E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,QAAQ,GACR,aAAa,GACb,WAAW,GACX,QAAQ,GACR,QAAQ,CAAC;AAEb,eAAO,MAAM,QAAQ,EAAE,SAAS,WAAW,EAO1C,CAAC;AAIF,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,WAAW,CAE1D"}
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../src/tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,2DAA4D,CAAC;AACxF,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,yCAA0C,CAAC;AAClE,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,sEAAsE;AACtE,eAAO,MAAM,eAAe,kLAQlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,+CAA+C;AAC/C,eAAO,MAAM,cAAc,uDAAwD,CAAC;AACpF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,0DAA0D;AAC1D,eAAO,MAAM,UAAU,6CAA8C,CAAC;AACtE,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,2CAA2C;AAC3C,eAAO,MAAM,UAAU,sDAAuD,CAAC;AAC/E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,QAAQ,GACR,aAAa,GACb,WAAW,GACX,QAAQ,GACR,QAAQ,CAAC;AAEb,eAAO,MAAM,QAAQ,EAAE,SAAS,WAAW,EAO1C,CAAC;AAIF,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,WAAW,CAE1D"}

package/dist/tags.js

@@ -11,16 +11,23 @@
  * Tag categories follow the `gherkin-features` skill: Milestone, Group,
  * Capability, Test type, Suite, Actor.
  */
-/** Which milestone a feature belongs to. Required — every Feature has exactly one. */
-export const MILESTONE_TAGS = ["@m1", "@m2", "@m3", "@m4", "@v1"];
+/**
+ * Which milestone a feature belongs to. Required — every Feature has exactly one.
+ *
+ * `@platform` marks cross-cutting platform capabilities (e.g. the artifact plugin
+ * system) that are orthogonal to the numbered milestone sequence, rather than
+ * belonging to a specific numbered milestone.
+ */
+export const MILESTONE_TAGS = ["@m1", "@m2", "@m3", "@m4", "@v1", "@platform"];
 /**
  * Which feature group a feature belongs to. Required — every Feature has
  * exactly one. Mirrors the folder layout under `features/`.
  *
  * - `@core` — base list app (text elements, add, delete, persist)
- * - Plugin groups will be added as plugins land: `@todo`, `@checklist`, etc.
+ * - `@artifact-plugins` — artifact-lifecycle/infra plugins (Sentry, PostHog)
+ * - Domain plugin groups will be added as they land: `@todo`, `@checklist`, etc.
  */
-export const GROUP_TAGS = ["@core"];
+export const GROUP_TAGS = ["@core", "@artifact-plugins"];
 /** What capability the feature exercises. Required — at least one. */
 export const CAPABILITY_TAGS = [
     "@capability:list",

package/dist/tags.js.map

@@ -1 +1 @@
-{"version":3,"file":"tags.js","sourceRoot":"","sources":["../src/tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,sFAAsF;AACtF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAG3E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAO,CAAU,CAAC;AAG7C,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,kBAAkB;IAClB,qBAAqB;IACrB,yBAAyB;IACzB,qBAAqB;IACrB,oBAAoB;IACpB,2BAA2B;IAC3B,qBAAqB;CACb,CAAC;AAGX,+CAA+C;AAC/C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,aAAa,EAAE,YAAY,EAAE,aAAa,CAAU,CAAC;AAGpF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAU,CAAC;AAGtE,2CAA2C;AAC3C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,aAAa,EAAE,WAAW,EAAE,aAAa,CAAU,CAAC;AAW/E,MAAM,CAAC,MAAM,QAAQ,GAA2B;IAC9C,GAAG,cAAc;IACjB,GAAG,UAAU;IACb,GAAG,eAAe;IAClB,GAAG,cAAc;IACjB,GAAG,UAAU;IACb,GAAG,UAAU;CACd,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,QAAQ,CAAC,CAAC;AAE1C,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../src/tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,CAAU,CAAC;AAGxF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,mBAAmB,CAAU,CAAC;AAGlE,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,kBAAkB;IAClB,qBAAqB;IACrB,yBAAyB;IACzB,qBAAqB;IACrB,oBAAoB;IACpB,2BAA2B;IAC3B,qBAAqB;CACb,CAAC;AAGX,+CAA+C;AAC/C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,aAAa,EAAE,YAAY,EAAE,aAAa,CAAU,CAAC;AAGpF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAU,CAAC;AAGtE,2CAA2C;AAC3C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,aAAa,EAAE,WAAW,EAAE,aAAa,CAAU,CAAC;AAW/E,MAAM,CAAC,MAAM,QAAQ,GAA2B;IAC9C,GAAG,cAAc;IACjB,GAAG,UAAU;IACb,GAAG,eAAe;IAClB,GAAG,cAAc;IACjB,GAAG,UAAU;IACb,GAAG,UAAU;CACd,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,QAAQ,CAAC,CAAC;AAE1C,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}

package/features/artifact-plugins/README.md

@@ -0,0 +1,58 @@
+# artifact-plugins — Artifact-lifecycle/infra plugins
+
+Feature group for the composable artifact plugin system (see
+[ADR 0016](../../../../docs/adrs/0016-artifact-plugin-system.md)). Covers
+plugins that hook into an artifact's lifecycle and event bus — Sentry error
+monitoring, PostHog analytics — as distinct from future domain-contribution
+plugins (checkbox, priority, etc.) which will get their own group folder(s)
+when they land.
+
+| File | Capability |
+|------|------------|
+| [sentry-error-capture.feature](sentry-error-capture.feature) | Sentry plugin initialization and error reporting |
+| [posthog-analytics-tracking.feature](posthog-analytics-tracking.feature) | PostHog plugin initialization and widget-displayed tracking |
+
+## Scope
+
+These scenarios describe plugin lifecycle mechanics — hook invocation and event
+reaction — at the Host/Plugin contract level, not real network behavior. No
+scenario should make a real Sentry or PostHog network call; "the plugin captures an
+event" means the plugin's own capture function was invoked with the expected
+payload.
+
+This is a `@platform` milestone group — orthogonal to the numbered `@m1`–`@m4`
+sequence, since the plugin system is cross-cutting infrastructure rather than a
+milestone-scoped list capability.
+
+## Status: `@todo`
+
+Both features are tagged `@todo` — the runner (`cli/alistigo-features-runner-playwright`)
+skips them rather than failing on undefined steps. Unlike the `core/` group, this
+runner is a real Playwright harness driving the built iframe against a live preview
+server, not an in-memory Application-layer runner. Implementing these scenarios for
+real requires:
+
+- Intercepting (via `page.route()`) the jsDelivr URL a plugin resolves to, so the
+  dynamic `import()` in `@alistigo/artifact-plugin-api`'s loader serves a local fake
+  plugin bundle instead of a real network request — keeping the scenario
+  network-free while still exercising the real load → `setup()` → event-subscription
+  path end-to-end.
+- An observable proxy for internal plugin/event state from the page — the exposed
+  `Alistigo.about()` debug API (`plugins: string[]`) covers "is a plugin loaded";
+  asserting an emitted event was actually captured needs either a page-side test hook
+  or a fake plugin bundle that writes an observable marker (e.g. a DOM attribute) when
+  its capture function runs.
+
+Remove `@todo` once that harness support exists and the steps are implemented.
+
+## Definition of Done
+
+This group is done when every scenario in this folder is green via the runner,
+and a plugin's own package (`@alistigo/artifact-sentry-plugin`,
+`@alistigo/artifact-posthog-plugin`) implements exactly the hooks these
+scenarios describe.
+
+See:
+- [`docs/adrs/0016-artifact-plugin-system.md`](../../../../docs/adrs/0016-artifact-plugin-system.md) for the design
+- [`docs/glossary.md`](../../docs/glossary.md) for the Plugin entity and Host actor
+- [`docs/style-guide.md`](../../docs/style-guide.md) for how to write a scenario

package/features/artifact-plugins/posthog-analytics-tracking.feature

@@ -0,0 +1,31 @@
+@platform
+@artifact-plugins
+@capability:plugins
+@actor:host
+@todo
+Feature: PostHog plugin tracks widget display
+  As the Host
+  I want the PostHog plugin to record a widget_displayed event on first mount
+  So that product usage is measurable without coupling core to a specific vendor
+
+  @happy-path
+  @smoke
+  Scenario: PostHog plugin captures widget_displayed on first mount
+    Given an artifact host with the PostHog plugin enabled and an API key configured
+    When the host completes its first mount
+    Then the host should emit a "widget:displayed" event with the locale, storage type, and version
+    And the PostHog plugin should capture a "widget_displayed" event with those properties
+
+  @edge-case
+  Scenario: PostHog plugin does not double-report on remount
+    Given an artifact host with the PostHog plugin enabled and an API key configured
+    And the host has already completed its first mount
+    When the host is mounted again on the same container
+    Then the host should not emit a second "widget:displayed" event
+
+  @edge-case
+  Scenario: PostHog plugin is a silent no-op without an API key
+    Given an artifact host with the PostHog plugin enabled but no API key configured
+    When the host completes its first mount
+    Then the PostHog plugin should report itself as not initialized
+    And the PostHog plugin should not capture any event

package/features/artifact-plugins/sentry-error-capture.feature

@@ -0,0 +1,30 @@
+@platform
+@artifact-plugins
+@capability:plugins
+@actor:host
+Feature: Sentry plugin captures render errors
+  As the Host
+  I want the Sentry plugin to observe and report uncaught render errors
+  So that developers learn about failures without manual instrumentation
+
+  @happy-path
+  Scenario: Sentry plugin initializes when a DSN is configured
+    Given the "@alistigo/artifact-sentry-plugin" plugin
+    And a non-initialized artifact "list" with plugin configured
+    When the artifact initialize
+    Then the plugin should be initialized
+
+  @happy-path
+  Scenario: An uncaught render error is reported through the plugin
+    Given the "@alistigo/artifact-sentry-plugin" plugin
+    And an initialized artifact "list" with plugin configured
+    When an uncaught render error occurs
+    Then the plugin should capture the error
+
+  @edge-case
+  Scenario: Sentry plugin is a silent no-op without a DSN
+    Given the "@alistigo/artifact-sentry-plugin" plugin
+    And an non-initialized artifact "list" with plugin not configured
+    When the artifact initialize
+    Then the plugin should report itself as not initialized
+    And no error should be thrown

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alistigo/features",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "license": "MIT",
   "author": {
     "name": "Mikael Labrut",