Skip to content

Release v2.1.0 — tooling conventions: Pattern A + B Phase B1 + D#8

Merged
Ronkupper merged 2 commits into
mainfrom
feat/v2.1.0-tooling-conventions
May 22, 2026
Merged

Release v2.1.0 — tooling conventions: Pattern A + B Phase B1 + D#8
Ronkupper merged 2 commits into
mainfrom
feat/v2.1.0-tooling-conventions

Conversation

@Ronkupper
Copy link
Copy Markdown
Owner

Bundles three independently-designed patterns into one MINOR release per PRISM-workshop/design/tooling_conventions_micro_dds_rev1.md X1.

What's in this PR

  • Pattern A — machine-readable frontmatter. PRISM.md frontmatter expanded into a single block with two comment-grouped sections (skill metadata + framework metadata). New fields: version, released, supersedes, lens_library_embedded, substrate_target, normativity, lint_catalog_version. Authoritative schema at PRISM-workshop/schemas/prism_frontmatter.schema.json (workshop-private; CI does best-effort fetch).
  • Pattern B Phase B1 — strength × polarity vocabulary. Frontmatter normativity block declares strength (required / recommended / optional, default required) and polarity glyphs ( / ⚠️ / 🚫). Title-block tag-convention paragraph extended with a two-sentence announcement (no new subsection). New elements use the extended [durability | review-trigger | strength? | polarity?] form going forward. Legacy element sweep deferred to v2.2.0 (Phase B2), gated on operator ratification of PRISM-workshop/notes/pattern_b_legacy_marker_proposals.md.
  • Pattern D — Appendix H, Vendor parsing observations. Six-status closed vocabulary (passthrough / stripped / mangled / error / not-tested / observed-once), per-content-type H3 sections with narrow per-vendor tables, observation-driven appends with release-sweep at 12-month staleness. Seed entry: ChatGPT mobile paste = stripped (the empirical observation that drove §4.12 atomic-prompt self-containment in v2.0.2).

Pattern C (lint catalog) ships off-cycle as lint-v1 in a separate PR; no PRISM.md content change tied to it.

Coupling watch-out

Per backlog_sequencing_dd_rev1.md Watch-out #2: bundling A + D + B Phase B1 silently couples three thinking sessions' delivery dates. Justified by review-surface efficiency — all three are independent content additions with no semantic conflict. Bundle would have broken rather than waited if any had blocked.

Ancillary updates

  • SKILL.md / CITATION.cff / README.md / VERSION refreshed to v2.1.0
  • PRISM_backlog.md bumped to v13 with shipped entries for v2.1.0 + lint-v1, plus active proposal for Pattern B Phase B2
  • PRISM_v2_1_0.md snapshot created; PRISM_v2_0_2.md retired
  • PRISM_backlog_v13.md snapshot created; PRISM_backlog_v6.md retired
  • RELEASING.md updated with lint-catalog release track + lint-gate pre-release checklist item

Verification

  • Frontmatter validates against prism_frontmatter.schema.json (check-jsonschema, exit 0)
  • Named-refs lint: 0 errors, 56 info (55 prior + 1 new from C.9 subsection, expected)
  • Title-block ↔ frontmatter ↔ description triple match: all v2.1.0
  • lens_library_embedded: "0.10" matches Appendix G v0.10
  • Snapshot byte-identical to stable file

Provenance

  • Survey: PRISM-workshop/design/tooling_conventions_survey_dd_rev1.md
  • Combined micro-DD: PRISM-workshop/design/tooling_conventions_micro_dds_rev1.md (rev1 + amendment, A1–X4)
  • Build handoff: PRISM-workshop/handoffs/tooling_conventions_micro_dds_build.md
  • Sequencing: PRISM-workshop/design/backlog_sequencing_dd_rev1.md

Merge sequence

Recommend merging the feat/lint-v1 PR first so the lint workflow exists on main when this PR re-runs CI. Tag v2.1.0 on this PR's merge commit; tag lint-v1 on the other PR's merge commit.

…endix H

Bundles three independently-designed patterns into one MINOR release per
PRISM-workshop/design/tooling_conventions_micro_dds_rev1.md X1:

- Pattern A — machine-readable frontmatter. Single YAML block with two
  comment-grouped sections (skill metadata + framework metadata). New
  fields: version, released, supersedes, lens_library_embedded,
  substrate_target, normativity, lint_catalog_version. Authoritative
  schema at PRISM-workshop/schemas/prism_frontmatter.schema.json.

- Pattern B Phase B1 — strength × polarity vocabulary. Frontmatter
  normativity block declares strength (required / recommended /
  optional, default required) and polarity glyphs (✅ ⚠️ 🚫). Title-block
  tag-convention paragraph extended with two-sentence announcement; new
  elements use [durability | review-trigger | strength? | polarity?]
  going forward. Legacy element sweep deferred to v2.2.0 (Phase B2),
  gated on operator ratification of PRISM-workshop/notes/
  pattern_b_legacy_marker_proposals.md.

- Pattern D — Appendix H, Vendor parsing observations. Six-status closed
  vocabulary, per-content-type H3 sections with narrow per-vendor tables,
  observation-driven appends with release-sweep at 12-month staleness.
  Seed entry: ChatGPT mobile paste = stripped (the empirical observation
  that drove §4.12 atomic-prompt self-containment in v2.0.2).

Coupling watch-out (per backlog_sequencing_dd_rev1.md Watch-out #2):
bundling three thinking sessions silently couples their delivery dates.
Bundle justified by review-surface efficiency — all three are independent
content additions with no semantic conflict. Bundle would have broken
rather than waited if any had blocked.

Pattern C (lint catalog) ships off-cycle as lint-v1 in a separate PR;
no PRISM.md content change tied to it.

Ancillary updates: SKILL.md / CITATION.cff / README.md / VERSION refreshed
to v2.1.0; PRISM_backlog.md bumped to v13 with shipped entries for the
v2.1.0 bundle and lint-v1 plus an active proposal entry for Pattern B
Phase B2; PRISM_v2_1_0.md snapshot created; PRISM_v2_0_2.md retired;
RELEASING.md updated with lint-catalog track and lint-gate pre-release
checklist item.
@github-actions
Copy link
Copy Markdown

Informational lint findings

56 info-level findings (non-blocking).

Rule File:Line Message
PRISM-LINT-02 PRISM.md:122 orphan section 'what-v2-1-0-does-not-cover' (never referenced)
PRISM-LINT-02 PRISM.md:170 orphan section 'construct-list' (never referenced)
PRISM-LINT-02 PRISM.md:224 orphan section 'visual-map' (never referenced)
PRISM-LINT-02 PRISM.md:385 orphan section 'lifecycle-slots' (never referenced)
PRISM-LINT-02 PRISM.md:402 orphan section 'band-legend' (never referenced)
PRISM-LINT-02 PRISM.md:415 orphan section 'cross-section-quick-find' (never referenced)
PRISM-LINT-02 PRISM.md:1840 orphan section 'probe-ordering-recommended-sequence' (never referenced)
PRISM-LINT-02 PRISM.md:1989 orphan section 'lens-schema-what-orchestration-consumes' (never referenced)
PRISM-LINT-02 PRISM.md:2019 orphan section 'specialist-pass-promotion' (never referenced)
PRISM-LINT-02 PRISM.md:2131 orphan section 'parked-v2-design-ideas' (never referenced)
PRISM-LINT-02 PRISM.md:2511 orphan section 'monitor-severity-report-format' (never referenced)
PRISM-LINT-02 PRISM.md:2726 orphan section 'filename-patterns' (never referenced)
PRISM-LINT-02 PRISM.md:2751 orphan section 'bump-atomicity-routine' (never referenced)
PRISM-LINT-02 PRISM.md:2858 orphan section 'what-v1-xs-atomic-template-carried-that-v2-reshapes' (never referenced)
PRISM-LINT-02 PRISM.md:2885 orphan section 'cloud-drive-and-persistence' (never referenced)
PRISM-LINT-02 PRISM.md:2892 orphan section 'mobile-platform-cues' (never referenced)
PRISM-LINT-02 PRISM.md:2909 orphan section 'multi-vendor-cues' (never referenced)
PRISM-LINT-02 PRISM.md:2917 orphan section 'recovery-cues' (never referenced)
PRISM-LINT-02 PRISM.md:2989 orphan section 'why-this-matters' (never referenced)
PRISM-LINT-02 PRISM.md:3148 orphan appendix 'samsung-file-explorer-llm-downloaded-files-invisible-until-indexing-catches-up' (never referenced)
PRISM-LINT-02 PRISM.md:3171 orphan appendix 'broken-file-clipboard-operations-in-llm-mobile-apps' (never referenced)
PRISM-LINT-02 PRISM.md:3196 orphan appendix 'artifact-handoff-together-present-document-with-instructions' (never referenced)
PRISM-LINT-02 PRISM.md:3225 orphan appendix 'session-retrieval-point-me-to-the-relevant-session' (never referenced)
PRISM-LINT-02 PRISM.md:3291 orphan appendix 'glossary' (never referenced)
PRISM-LINT-02 PRISM.md:3357 orphan appendix 'spec-v2-0-source-mapping' (never referenced)
PRISM-LINT-02 PRISM.md:3425 orphan appendix 'decision-tag-index' (never referenced)
PRISM-LINT-02 PRISM.md:3437 orphan appendix 'structural-stable' (never referenced)
PRISM-LINT-02 PRISM.md:3459 orphan appendix 'methodological-stable' (never referenced)
PRISM-LINT-02 PRISM.md:3468 orphan appendix 'methodological-review-if-substrate-shifts' (never referenced)
PRISM-LINT-02 PRISM.md:3473 orphan appendix 'methodological-review-if-vendor-landscape-changes' (never referenced)
PRISM-LINT-02 PRISM.md:3478 orphan appendix 'vendor-dependent-review-if-orchestration-vendor-changes' (never referenced)
PRISM-LINT-02 PRISM.md:3483 orphan appendix 'vendor-dependent-review-if-vendor-landscape-changes' (never referenced)
PRISM-LINT-02 PRISM.md:3488 orphan appendix 'operator-scaffolding-stable' (never referenced)
PRISM-LINT-02 PRISM.md:3496 orphan appendix 'empirical-review-annually' (never referenced)
PRISM-LINT-02 PRISM.md:3502 orphan appendix 'methodological-review-if-release-sweep-recommended' (never referenced)
PRISM-LINT-02 PRISM.md:3529 orphan appendix 'v1-x-v2-surface-drift' (never referenced)
PRISM-LINT-02 PRISM.md:3536 orphan appendix 'sessions-and-lifecycle' (never referenced)
PRISM-LINT-02 PRISM.md:3548 orphan appendix 'probes' (never referenced)
PRISM-LINT-02 PRISM.md:3571 orphan appendix 'monitors' (never referenced)
PRISM-LINT-02 PRISM.md:3589 orphan appendix 'standing-principles' (never referenced)
PRISM-LINT-02 PRISM.md:3608 orphan appendix 'other-constructs' (never referenced)
PRISM-LINT-02 PRISM.md:3625 orphan appendix 'nomenclature-changes' (never referenced)
PRISM-LINT-02 PRISM.md:3643 orphan appendix 'templates-compendium' (never referenced)
PRISM-LINT-02 PRISM.md:3648 orphan appendix 'prism-execution-envelope' (never referenced)
PRISM-LINT-02 PRISM.md:3669 orphan appendix 'prism-execution-self-check' (never referenced)
PRISM-LINT-02 PRISM.md:3691 orphan appendix 'prism-execution-output' (never referenced)
PRISM-LINT-02 PRISM.md:3714 orphan appendix 'vendor-selection-block' (never referenced)
PRISM-LINT-02 PRISM.md:3727 orphan appendix 'whats-next' (never referenced)
PRISM-LINT-02 PRISM.md:3757 orphan appendix 'vendor-triangulation-delta' (never referenced)
PRISM-LINT-02 PRISM.md:3775 orphan appendix 'migration-handoff' (never referenced)

…and 6 more.

@Ronkupper Ronkupper merged commit 93aa324 into main May 22, 2026
2 checks passed
Ronkupper added a commit that referenced this pull request May 22, 2026
Bundles Pattern A (frontmatter) + Pattern B Phase B1 (normativity vocabulary) + Pattern D (Appendix H — Vendor parsing observations) per design/tooling_conventions_micro_dds_rev1.md X1.
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