npm - @afokapu/atdd-bun - Versions diffs - 0.10.32 → 0.10.34 - Mend

@afokapu/atdd-bun 0.10.32 → 0.10.34

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (29) hide show

package/README.md +14 -10
package/conventions/_profiles/architecture.yaml +190 -0
package/conventions/_profiles/coder.yaml +804 -0
package/conventions/_profiles/design.yaml +219 -0
package/conventions/_profiles/docs.yaml +136 -0
package/conventions/_profiles/htmx.yaml +436 -0
package/conventions/_profiles/interlocking.yaml +248 -0
package/conventions/_profiles/metrics.yaml +80 -0
package/conventions/_profiles/planner.yaml +789 -0
package/conventions/_profiles/runtime.yaml +62 -0
package/conventions/_profiles/security.yaml +70 -0
package/conventions/_profiles/telemetry.yaml +196 -0
package/conventions/_profiles/tester.yaml +734 -0
package/conventions/_profiles/topology.yaml +192 -0
package/conventions/_profiles/traceability.yaml +94 -0
package/conventions/_profiles/workflow.yaml +7 -0
package/conventions/atdd-bun.profiles/atdd-bun.profiles.presets.convention.yaml +24 -2
package/integrity.json +27 -12
package/package.json +2 -1
package/src/agent.ts +15 -15
package/src/cli.ts +7 -0
package/src/enforce.ts +23 -10
package/src/hooks.ts +3 -3
package/src/index.ts +1 -0
package/src/integrity.ts +0 -2
package/src/profile-registry.ts +78 -0
package/src/setup.ts +4 -4
package/templates/agents/AGENTS.block.md +4 -6
package/templates/agents/atdd/SKILL.md +0 -20

package/conventions/_profiles/design.yaml ADDED Viewed

@@ -0,0 +1,219 @@
+schema_version: "1.0.0"
+profile: "design"
+implementations:
+  - "bun_design_system_detector"
+  - "bun_responsive_detector"
+conventions:
+  - rule_id: "coder.bun.design-connected"
+    path: "conventions/coder.bun/coder.bun.design-connected.convention.yaml"
+  - rule_id: "coder.bun.design-dependency-flow"
+    path: "conventions/coder.bun/coder.bun.design-dependency-flow.convention.yaml"
+  - rule_id: "coder.bun.design-orphan-export"
+    path: "conventions/coder.bun/coder.bun.design-orphan-export.convention.yaml"
+  - rule_id: "coder.bun.design-primitives"
+    path: "conventions/coder.bun/coder.bun.design-primitives.convention.yaml"
+  - rule_id: "coder.bun.design-token-color"
+    path: "conventions/coder.bun/coder.bun.design-token-color.convention.yaml"
+  - rule_id: "coder.bun.design-token-hardcoded"
+    path: "conventions/coder.bun/coder.bun.design-token-hardcoded.convention.yaml"
+  - rule_id: "coder.bun.design-tokens-pure"
+    path: "conventions/coder.bun/coder.bun.design-tokens-pure.convention.yaml"
+  - rule_id: "coder.bun.design-wagons-import"
+    path: "conventions/coder.bun/coder.bun.design-wagons-import.convention.yaml"
+  - rule_id: "coder.bun.responsive-breakpoints-declared"
+    path: "conventions/coder.bun/coder.bun.responsive-breakpoints-declared.convention.yaml"
+  - rule_id: "coder.bun.responsive-no-fixed-width"
+    path: "conventions/coder.bun/coder.bun.responsive-no-fixed-width.convention.yaml"
+  - rule_id: "coder.bun.responsive-viewport-meta"
+    path: "conventions/coder.bun/coder.bun.responsive-viewport-meta.convention.yaml"
+relationships:
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "a rendering component must use the design system, and render its controls through primitives"
+    source_ref: "coder.bun.design-connected"
+    strength: "important"
+    target_ref: "coder.bun.design-primitives"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "Bun realization of the core obligation coder.design.orphan-ui, checked over .tsx, .jsx, .html and .css"
+    source_ref: "coder.bun.design-connected"
+    strength: "important"
+    target_ref: "coder.design.orphan-ui"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "code layering and design-system layering: both require dependencies to point in one direction"
+    source_ref: "coder.bun.design-dependency-flow"
+    strength: "important"
+    target_ref: "coder.bun.design-hierarchy-import"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "two halves of coder.design.hierarchy-import: imports flow down the layers, and never out into app code"
+    source_ref: "coder.bun.design-dependency-flow"
+    strength: "critical"
+    target_ref: "coder.bun.design-wagons-import"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "Bun realization of the core obligation coder.design.hierarchy-import, checked over .tsx, .jsx, .html and .css"
+    source_ref: "coder.bun.design-dependency-flow"
+    strength: "important"
+    target_ref: "coder.design.hierarchy-import"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "Bun realization of the core obligation coder.design.orphan-export, checked over .tsx, .jsx, .html and .css"
+    source_ref: "coder.bun.design-orphan-export"
+    strength: "important"
+    target_ref: "coder.design.orphan-export"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "Bun realization of the core obligation coder.design.primitives, checked over .tsx, .jsx, .html and .css"
+    source_ref: "coder.bun.design-primitives"
+    strength: "important"
+    target_ref: "coder.design.primitives"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "colors, and spacing, radii and durations: together, every visual value outside the tokens layer comes from tokens"
+    source_ref: "coder.bun.design-token-color"
+    strength: "important"
+    target_ref: "coder.bun.design-token-hardcoded"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "colors can only be referenced from tokens once the tokens layer holds pure values"
+    source_ref: "coder.bun.design-token-color"
+    strength: "important"
+    target_ref: "coder.bun.design-tokens-pure"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "Bun realization of the core obligation coder.design.token-color, checked over .tsx, .jsx, .html and .css"
+    source_ref: "coder.bun.design-token-color"
+    strength: "important"
+    target_ref: "coder.design.token-color"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "Bun realization of the core obligation coder.design.token-hardcoded, checked over .tsx, .jsx, .html and .css"
+    source_ref: "coder.bun.design-token-hardcoded"
+    strength: "important"
+    target_ref: "coder.design.token-hardcoded"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "Bun realization of the core obligation coder.design.foundations, checked over .tsx, .jsx, .html and .css"
+    source_ref: "coder.bun.design-tokens-pure"
+    strength: "important"
+    target_ref: "coder.design.foundations"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "Bun realization of the core obligation coder.design.hierarchy-import, checked over .tsx, .jsx, .html and .css"
+    source_ref: "coder.bun.design-wagons-import"
+    strength: "important"
+    target_ref: "coder.design.hierarchy-import"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "breakpoints are declared once like tokens, because media queries cannot read custom properties"
+    source_ref: "coder.bun.responsive-breakpoints-declared"
+    strength: "important"
+    target_ref: "coder.bun.design-token-hardcoded"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "what a layout may be wide, and where it may switch: together, a layout that adapts at the declared widths"
+    source_ref: "coder.bun.responsive-no-fixed-width"
+    strength: "important"
+    target_ref: "coder.bun.responsive-breakpoints-declared"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "widths only mean device widths once the document declares a device-width viewport"
+    source_ref: "coder.bun.responsive-viewport-meta"
+    strength: "critical"
+    target_ref: "coder.bun.responsive-no-fixed-width"
+    type: "enables"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "a viewport that blocks zoom is an accessibility failure as well as a responsive one"
+    source_ref: "coder.bun.responsive-viewport-meta"
+    strength: "important"
+    target_ref: "tester.htmx.a11y-harness"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "the static cause and the rendered proof of horizontal overflow"
+    source_ref: "tester.htmx.responsive-harness"
+    strength: "important"
+    target_ref: "coder.bun.responsive-no-fixed-width"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "a browser can only prove a page fits a phone once the page declares a device-width viewport"
+    source_ref: "tester.htmx.responsive-harness"
+    strength: "critical"
+    target_ref: "coder.bun.responsive-viewport-meta"
+    type: "requires"

package/conventions/_profiles/docs.yaml ADDED Viewed

@@ -0,0 +1,136 @@
+schema_version: "1.0.0"
+profile: "docs"
+implementations:
+  - "planner_docs_capability"
+conventions:
+  - rule_id: "planner.docs.adr-registry-derived"
+    path: "conventions/planner.docs/planner.docs.adr-registry-derived.convention.yaml"
+  - rule_id: "planner.docs.area-index-required"
+    path: "conventions/planner.docs/planner.docs.area-index-required.convention.yaml"
+  - rule_id: "planner.docs.artifact-path-shape"
+    path: "conventions/planner.docs/planner.docs.artifact-path-shape.convention.yaml"
+  - rule_id: "planner.docs.asciidoc-only"
+    path: "conventions/planner.docs/planner.docs.asciidoc-only.convention.yaml"
+  - rule_id: "planner.docs.doc-id-unique"
+    path: "conventions/planner.docs/planner.docs.doc-id-unique.convention.yaml"
+  - rule_id: "planner.docs.graph-target-resolves"
+    path: "conventions/planner.docs/planner.docs.graph-target-resolves.convention.yaml"
+  - rule_id: "planner.docs.identity-required"
+    path: "conventions/planner.docs/planner.docs.identity-required.convention.yaml"
+  - rule_id: "planner.docs.journey-view-current"
+    path: "conventions/planner.docs/planner.docs.journey-view-current.convention.yaml"
+  - rule_id: "planner.docs.reference-integrity"
+    path: "conventions/planner.docs/planner.docs.reference-integrity.convention.yaml"
+  - rule_id: "planner.docs.undeclared-change"
+    path: "conventions/planner.docs/planner.docs.undeclared-change.convention.yaml"
+relationships:
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.planner.docs/relationships.yaml"
+    reason: "The registry is a projection of :decides: edges, so it is only as trustworthy as edge resolution. An ADR deciding an undeclared node is reported by the resolver, never listed in the registry."
+    source_ref: "planner.docs.adr-registry-derived"
+    strength: "important"
+    target_ref: "planner.docs.graph-target-resolves"
+    type: "requires"
+  - confidence: 1
+    constraint: "discretionary"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.planner.docs/relationships.yaml"
+    reason: "Both are canonical-tree shape rules read from the same scan of docs/: one governs what an area contains, the other what format its files are in."
+    source_ref: "planner.docs.area-index-required"
+    strength: "minor"
+    target_ref: "planner.docs.asciidoc-only"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.planner.docs/relationships.yaml"
+    reason: "Uniqueness compares ids that were actually declared; a document with no doc-id is reported by identity-required and never counted as a collision here."
+    source_ref: "planner.docs.doc-id-unique"
+    strength: "critical"
+    target_ref: "planner.docs.identity-required"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.planner.docs/relationships.yaml"
+    reason: "Resolution needs exactly one target per id. Under a duplicate, :supersedes: cannot say which document it means, so uniqueness must hold before an edge can be said to resolve."
+    source_ref: "planner.docs.graph-target-resolves"
+    strength: "critical"
+    target_ref: "planner.docs.doc-id-unique"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.planner.docs/relationships.yaml"
+    reason: "The declared-id set is built from :doc-id: attributes BEFORE any edge is resolved. This edge is the no-fabrication discipline expressed as an ordering: without the set first, the resolver would have to invent what it resolves against."
+    source_ref: "planner.docs.graph-target-resolves"
+    strength: "critical"
+    target_ref: "planner.docs.identity-required"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.planner.docs/relationships.yaml"
+    reason: "A doc-id lives in an AsciiDoc attribute. A markdown document has nowhere to declare one, so format uniformity is the precondition for identity."
+    source_ref: "planner.docs.identity-required"
+    strength: "critical"
+    target_ref: "planner.docs.asciidoc-only"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "the generated page is a document like any other and must carry its doc-id and status"
+    source_ref: "planner.docs.journey-view-current"
+    strength: "important"
+    target_ref: "planner.docs.identity-required"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "both keep the rendered documentation truthful: one that references resolve, the other that the drawn journeys are the planned ones"
+    source_ref: "planner.docs.journey-view-current"
+    strength: "important"
+    target_ref: "planner.docs.reference-integrity"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "the journey view is rendered from the journey topology the plan declares"
+    source_ref: "planner.docs.journey-view-current"
+    strength: "critical"
+    target_ref: "planner.journey.definition"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.planner.docs/relationships.yaml"
+    reason: "asciidoctor renders the authored corpus. A markdown file under docs/ is not an input the renderer can resolve references through, so the format rule bounds what reference-integrity can even see."
+    source_ref: "planner.docs.reference-integrity"
+    strength: "important"
+    target_ref: "planner.docs.asciidoc-only"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.planner.docs/relationships.yaml"
+    reason: "The two halves of the declaration check: one asks whether a declared path is SHAPED like documentation, the other whether a documentation change was declared at all. Together they close the loop core opens; neither alone does."
+    source_ref: "planner.docs.undeclared-change"
+    strength: "critical"
+    target_ref: "planner.docs.artifact-path-shape"
+    type: "runs_alongside"