npm - @prismer/runtime - Versions diffs - 2.2.55 → 2.2.64 - Mend

@prismer/runtime 2.2.55 → 2.2.64

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 (563) hide show

package/built-in-skills/pkf-svg/references/architecture-diagram/templates/template.html ADDED Viewed

@@ -0,0 +1,345 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>[PROJECT NAME] Architecture Diagram</title>
+  <style>
+    * {
+      margin: 0;
+      padding: 0;
+      box-sizing: border-box;
+    }
+    body {
+      font-family: ui-monospace, monospace;
+      background: #020617;
+      min-height: 100vh;
+      padding: 2rem;
+      color: white;
+    }
+    .container {
+      max-width: 1200px;
+      margin: 0 auto;
+    }
+    .header {
+      margin-bottom: 2rem;
+    }
+    .header-row {
+      display: flex;
+      align-items: center;
+      gap: 1rem;
+      margin-bottom: 0.5rem;
+    }
+    .pulse-dot {
+      width: 12px;
+      height: 12px;
+      background: #22d3ee;
+      border-radius: 50%;
+      animation: pulse 2s infinite;
+    }
+    @keyframes pulse {
+      0%, 100% { opacity: 1; }
+      50% { opacity: 0.5; }
+    }
+    h1 {
+      font-size: 1.5rem;
+      font-weight: 700;
+      letter-spacing: 0;
+    }
+    .subtitle {
+      color: #94a3b8;
+      font-size: 0.875rem;
+      margin-left: 1.75rem;
+    }
+    .diagram-container {
+      background: #0f172a;
+      border-radius: 1rem;
+      border: 1px solid #1e293b;
+      padding: 1.5rem;
+      overflow-x: auto;
+    }
+    svg {
+      width: 100%;
+      min-width: 900px;
+      display: block;
+    }
+    .cards {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(min(100%, 280px), 1fr));
+      gap: 1rem;
+      margin-top: 2rem;
+    }
+    .card {
+      background: #0f172a;
+      border-radius: 0.75rem;
+      border: 1px solid #1e293b;
+      padding: 1.25rem;
+    }
+    .card-header {
+      display: flex;
+      align-items: center;
+      gap: 0.5rem;
+      margin-bottom: 0.75rem;
+    }
+    .card-dot {
+      width: 8px;
+      height: 8px;
+      border-radius: 50%;
+    }
+    .card-dot.cyan { background: #22d3ee; }
+    .card-dot.emerald { background: #34d399; }
+    .card-dot.violet { background: #a78bfa; }
+    .card-dot.amber { background: #fbbf24; }
+    .card-dot.rose { background: #fb7185; }
+    .card h3 {
+      font-size: 0.875rem;
+      font-weight: 600;
+    }
+    .card ul {
+      list-style: none;
+      color: #94a3b8;
+      font-size: 0.75rem;
+    }
+    .card li {
+      margin-bottom: 0.375rem;
+    }
+    .footer {
+      text-align: center;
+      margin-top: 1.5rem;
+      color: #475569;
+      font-size: 0.75rem;
+    }
+  @media (prefers-color-scheme: light) {
+      body { background: #ffffff; color: #202124; }
+      .subtitle, .footer { color: #4b5563; }
+      .card { background: #f3f4f6; color: #202124; }
+      .card ul { color: #4b5563; }
+    }
+    @media (max-width: 600px) { body { padding: 1rem; } .header-row { flex-wrap: wrap; } }
+    @media (prefers-reduced-motion: reduce) { .pulse-dot { animation: none; } }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <!-- Header -->
+    <div class="header">
+      <div class="header-row">
+        <div class="pulse-dot"></div>
+        <h1>[PROJECT NAME] Architecture</h1>
+      </div>
+      <p class="subtitle">[Subtitle description]</p>
+    </div>
+    <!-- Main Diagram -->
+    <div class="diagram-container">
+      <svg viewBox="0 0 1000 850" role="img" aria-labelledby="diagram-title diagram-desc">
+        <title id="diagram-title">Example service architecture</title>
+        <desc id="diagram-desc">Users reach a CDN, load balancer, API server and database. Authentication is external. A legend below the cloud boundary explains the categories.</desc>
+        <!-- Definitions -->
+        <defs>
+          <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+            <polygon points="0 0, 10 3.5, 0 7" fill="#64748b" />
+          </marker>
+          <pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse">
+            <path d="M 40 0 L 0 0 0 40" fill="none" stroke="#1e293b" stroke-width="0.5"/>
+          </pattern>
+        </defs>
+        <!-- Background Grid -->
+        <rect width="100%" height="100%" fill="url(#grid)" />
+        <!-- =================================================================
+             COMPONENT EXAMPLES - Copy and customize these patterns
+             ================================================================= -->
+        <!-- Region/Cloud Boundary -->
+        <rect x="160" y="40" width="820" height="620" rx="12" fill="#0f172a" stroke="none" stroke-width="1" stroke-dasharray="8,4"/>
+        <rect x="160" y="40" width="820" height="620" rx="12" fill="rgba(251, 191, 36, 0.05)" stroke="#fbbf24" stroke-width="1" stroke-dasharray="8,4"/>
+        <text x="172" y="58" fill="#fbbf24" font-size="11" font-weight="600">AWS Region: us-west-2</text>
+        <!-- Standard arrow with label -->
+        <line x1="130" y1="305" x2="198" y2="305" stroke="#22d3ee" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+        <text x="164" y="299" fill="#94a3b8" font-size="11" text-anchor="middle">HTTPS</text>
+        <!-- Simple arrow (no label) -->
+        <line x1="310" y1="305" x2="358" y2="305" stroke="#22d3ee" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+        <!-- Vertical arrow -->
+        <line x1="255" y1="330" x2="255" y2="378" stroke="#fbbf24" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+        <text x="270" y="358" fill="#94a3b8" font-size="11">OAI</text>
+        <!-- Dashed arrow (for auth/security flows) -->
+        <line x1="460" y1="305" x2="508" y2="305" stroke="#34d399" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+        <line x1="620" y1="305" x2="698" y2="305" stroke="#a78bfa" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+        <text x="655" y="299" fill="#94a3b8" font-size="11">TLS</text>
+        <!-- Curved path for auth flow -->
+        <path d="M 80 140 L 80 200 Q 80 220 100 220 L 200 220 Q 220 220 220 240 L 220 278" fill="none" stroke="#fb7185" stroke-width="1.5" stroke-dasharray="5,5"/>
+        <text x="150" y="210" fill="#fb7185" font-size="11">JWT + PKCE</text>
+        <!-- External/Generic Component -->
+        <rect x="30" y="280" width="100" height="50" rx="6" fill="#0f172a" stroke="none" stroke-width="1.5"/>
+        <rect x="30" y="280" width="100" height="50" rx="6" fill="rgba(30, 41, 59, 0.5)" stroke="#94a3b8" stroke-width="1.5"/>
+        <text x="80" y="300" fill="white" font-size="11" font-weight="600" text-anchor="middle">Users</text>
+        <text x="80" y="316" fill="#94a3b8" font-size="11" text-anchor="middle">Browser/Mobile</text>
+        <!-- Security Component -->
+        <rect x="30" y="80" width="100" height="60" rx="6" fill="#0f172a" stroke="none" stroke-width="1.5"/>
+        <rect x="30" y="80" width="100" height="60" rx="6" fill="rgba(136, 19, 55, 0.4)" stroke="#fb7185" stroke-width="1.5"/>
+        <text x="80" y="105" fill="white" font-size="11" font-weight="600" text-anchor="middle">Auth Provider</text>
+        <text x="80" y="121" fill="#94a3b8" font-size="11" text-anchor="middle">OAuth 2.0</text>
+        <!-- AWS/Cloud Service -->
+        <rect x="200" y="280" width="110" height="50" rx="6" fill="#0f172a" stroke="none" stroke-width="1.5"/>
+        <rect x="200" y="280" width="110" height="50" rx="6" fill="rgba(120, 53, 15, 0.3)" stroke="#fbbf24" stroke-width="1.5"/>
+        <text x="255" y="300" fill="white" font-size="11" font-weight="600" text-anchor="middle">CloudFront</text>
+        <text x="255" y="316" fill="#94a3b8" font-size="11" text-anchor="middle">CDN</text>
+        <!-- Multi-line AWS Component (S3 Buckets example) -->
+        <rect x="200" y="380" width="110" height="100" rx="6" fill="#0f172a" stroke="none" stroke-width="1.5"/>
+        <rect x="200" y="380" width="110" height="100" rx="6" fill="rgba(120, 53, 15, 0.3)" stroke="#fbbf24" stroke-width="1.5"/>
+        <text x="255" y="400" fill="white" font-size="11" font-weight="600" text-anchor="middle">S3 Buckets</text>
+        <text x="255" y="420" fill="#94a3b8" font-size="11" text-anchor="middle">• bucket-one</text>
+        <text x="255" y="434" fill="#94a3b8" font-size="11" text-anchor="middle">• bucket-two</text>
+        <text x="255" y="448" fill="#94a3b8" font-size="11" text-anchor="middle">• bucket-three</text>
+        <text x="255" y="466" fill="#fbbf24" font-size="11" text-anchor="middle">OAI Protected</text>
+        <!-- Security Group (dashed boundary) -->
+        <rect x="350" y="265" width="120" height="80" rx="8" fill="transparent" stroke="#fb7185" stroke-width="1" stroke-dasharray="4,4"/>
+        <text x="358" y="274" fill="#fb7185" font-size="11">sg-name :port</text>
+        <!-- Component inside security group -->
+        <rect x="360" y="280" width="100" height="50" rx="6" fill="#0f172a" stroke="none" stroke-width="1.5"/>
+        <rect x="360" y="280" width="100" height="50" rx="6" fill="rgba(120, 53, 15, 0.3)" stroke="#fbbf24" stroke-width="1.5"/>
+        <text x="410" y="300" fill="white" font-size="11" font-weight="600" text-anchor="middle">Load Balancer</text>
+        <text x="410" y="316" fill="#94a3b8" font-size="11" text-anchor="middle">HTTPS :443</text>
+        <!-- Backend Component -->
+        <rect x="510" y="280" width="110" height="50" rx="6" fill="#0f172a" stroke="none" stroke-width="1.5"/>
+        <rect x="510" y="280" width="110" height="50" rx="6" fill="rgba(6, 78, 59, 0.4)" stroke="#34d399" stroke-width="1.5"/>
+        <text x="565" y="300" fill="white" font-size="11" font-weight="600" text-anchor="middle">API Server</text>
+        <text x="565" y="316" fill="#94a3b8" font-size="11" text-anchor="middle">FastAPI :8000</text>
+        <!-- Database Component -->
+        <rect x="700" y="280" width="120" height="50" rx="6" fill="#0f172a" stroke="none" stroke-width="1.5"/>
+        <rect x="700" y="280" width="120" height="50" rx="6" fill="rgba(76, 29, 149, 0.4)" stroke="#a78bfa" stroke-width="1.5"/>
+        <text x="760" y="300" fill="white" font-size="11" font-weight="600" text-anchor="middle">Database</text>
+        <text x="760" y="316" fill="#94a3b8" font-size="11" text-anchor="middle">PostgreSQL</text>
+        <!-- Frontend Component -->
+        <rect x="200" y="520" width="200" height="110" rx="8" fill="#0f172a" stroke="none" stroke-width="1.5"/>
+        <rect x="200" y="520" width="200" height="110" rx="8" fill="rgba(8, 51, 68, 0.4)" stroke="#22d3ee" stroke-width="1.5"/>
+        <text x="300" y="545" fill="white" font-size="12" font-weight="600" text-anchor="middle">Frontend</text>
+        <text x="300" y="565" fill="#94a3b8" font-size="11" text-anchor="middle">React + TypeScript</text>
+        <text x="300" y="580" fill="#94a3b8" font-size="11" text-anchor="middle">Additional detail</text>
+        <text x="300" y="595" fill="#94a3b8" font-size="11" text-anchor="middle">More info</text>
+        <text x="300" y="615" fill="#22d3ee" font-size="11" text-anchor="middle">domain.example.com</text>
+        <!-- =================================================================
+             ARROW EXAMPLES
+             ================================================================= -->
+        <!-- =================================================================
+             LEGEND
+             ================================================================= -->
+<g id="legend" transform="translate(0 624)">
+        <text x="720" y="70" fill="white" font-size="11" font-weight="600">Legend</text>
+        <rect x="720" y="82" width="16" height="10" rx="2" fill="#0f172a" stroke="none" stroke-width="1"/>
+        <rect x="720" y="82" width="16" height="10" rx="2" fill="rgba(8, 51, 68, 0.4)" stroke="#22d3ee" stroke-width="1"/>
+        <text x="742" y="90" fill="#94a3b8" font-size="11">Frontend</text>
+        <rect x="720" y="98" width="16" height="10" rx="2" fill="#0f172a" stroke="none" stroke-width="1"/>
+        <rect x="720" y="98" width="16" height="10" rx="2" fill="rgba(6, 78, 59, 0.4)" stroke="#34d399" stroke-width="1"/>
+        <text x="742" y="106" fill="#94a3b8" font-size="11">Backend</text>
+        <rect x="720" y="114" width="16" height="10" rx="2" fill="#0f172a" stroke="none" stroke-width="1"/>
+        <rect x="720" y="114" width="16" height="10" rx="2" fill="rgba(120, 53, 15, 0.3)" stroke="#fbbf24" stroke-width="1"/>
+        <text x="742" y="122" fill="#94a3b8" font-size="11">Cloud Service</text>
+        <rect x="720" y="130" width="16" height="10" rx="2" fill="#0f172a" stroke="none" stroke-width="1"/>
+        <rect x="720" y="130" width="16" height="10" rx="2" fill="rgba(76, 29, 149, 0.4)" stroke="#a78bfa" stroke-width="1"/>
+        <text x="742" y="138" fill="#94a3b8" font-size="11">Database</text>
+        <rect x="720" y="146" width="16" height="10" rx="2" fill="#0f172a" stroke="none" stroke-width="1"/>
+        <rect x="720" y="146" width="16" height="10" rx="2" fill="rgba(136, 19, 55, 0.4)" stroke="#fb7185" stroke-width="1"/>
+        <text x="742" y="154" fill="#94a3b8" font-size="11">Security</text>
+        <line x1="720" y1="168" x2="736" y2="168" stroke="#fb7185" stroke-width="1" stroke-dasharray="3,3"/>
+        <text x="742" y="171" fill="#94a3b8" font-size="11">Auth Flow</text>
+        <rect x="720" y="178" width="16" height="10" rx="2" fill="transparent" stroke="#fb7185" stroke-width="1" stroke-dasharray="3,3"/>
+        <text x="742" y="186" fill="#94a3b8" font-size="11">Security Group</text>
+</g>
+      </svg>
+    </div>
+    <!-- Info Cards -->
+    <div class="cards">
+      <div class="card">
+        <div class="card-header">
+          <div class="card-dot rose"></div>
+          <h3>Card Title 1</h3>
+        </div>
+        <ul>
+          <li>• Item one</li>
+          <li>• Item two</li>
+          <li>• Item three</li>
+          <li>• Item four</li>
+        </ul>
+      </div>
+      <div class="card">
+        <div class="card-header">
+          <div class="card-dot amber"></div>
+          <h3>Card Title 2</h3>
+        </div>
+        <ul>
+          <li>• Item one</li>
+          <li>• Item two</li>
+          <li>• Item three</li>
+          <li>• Item four</li>
+        </ul>
+      </div>
+      <div class="card">
+        <div class="card-header">
+          <div class="card-dot violet"></div>
+          <h3>Card Title 3</h3>
+        </div>
+        <ul>
+          <li>• Item one</li>
+          <li>• Item two</li>
+          <li>• Item three</li>
+          <li>• Item four</li>
+        </ul>
+      </div>
+    </div>
+    <!-- Footer -->
+    <p class="footer">
+      [Project Name] • [Additional metadata]
+    </p>
+  </div>
+</body>
+</html>

package/built-in-skills/pkf-writing/SKILL.md CHANGED Viewed

@@ -40,7 +40,8 @@ Runtime still extracts the bytes between the two sentinels
 ```text
 1. choose carrier + authority → message inline | Library Asset | Memory Page
 2. inspect source and refs    → copy real resolved URIs; never fabricate
-3. mint + author + validate   → `pkf_mint_sids` once; repair every error; resolve referenced assets
+3. mint + author + review     → `pkf_mint_sids` once; run the quality gate below; repair
+   every error; resolve referenced assets
 4. persist through owner      → `pkf_reply_inline` | Library/bundle writer | memory writer
 5. readback + project         → URI/revision/hash + resolved validation; concise Markdown projection
 ```
@@ -83,19 +84,39 @@ The `.pkf` file is ordinary UTF-8. Validate the whole page after every edit;
 a 409/412 means re-read and re-target, never force. After persistence, read
 back canonical bytes/receipt and run resolved validation where supported.
-## Report quality floor
+## Report quality floor + full-document review gate
-Before `pkf_reply_inline` or any carrier persist, run a quality self-check.
-A valid PKF shell can still be an unacceptable deliverable: strict validation
-only proves the carrier is parseable. For substantive research memos,
-playbooks, and architecture reviews, unless the user asks plain text, include:
+Before `pkf_reply_inline` or any carrier persist, run this gate. A valid PKF
+shell can still be an unacceptable deliverable: strict validation only proves
+the carrier is parseable. For substantive research memos, playbooks, and
+architecture reviews, unless the user asks plain text, include:
 - five or more semantic sections, including decision/summary and action/checklist;
-- at least two rich affordances chosen by need: comparison/risk/ownership table,
-  `<prismer-diagram ...>`, `<prismer-data ...>`, `<prismer-widget ...>`, or
-  CONTROLLED `prismer-svg` via `pkf-svg` + `pkf_svg_check`;
+- at least two rich affordances chosen by need — plain tables do NOT count
+  toward the two: `<prismer-diagram ...>`, `<prismer-data ...>`,
+  `<prismer-widget ...>`, or CONTROLLED `prismer-svg` via `pkf-svg` +
+  `pkf_svg_check`;
 - caption/alt text that explains what each visual proves, not decoration.
-If no visual/data/widget is useful, state that in the Markdown projection after readback; never add ornamental content just to satisfy the checklist.
+Then review the COMPLETE draft once against the content→visual selection table
+above, filtering quality defects that model habit or context pressure inject.
+Repair every failed check by editing (convert, split, delete) — never by arguing in prose:
+1. shape→carrier: name each major section's dominant shape (numbers compared /
+   trend / part-to-whole / entities+relationships / decision flow / phases);
+   where the table routes that shape to a diagram or chart, that element must
+   be present — a prose enumeration or a default table is a failed check, not
+   a style choice.
+2. no duplication: a fact a visual already shows is removed from body prose;
+   the visual keeps structure, prose keeps interpretation, source qualifiers,
+   and facts the visual cannot hold.
+3. captions: every visual's caption states what it proves, not decoration;
+   alt text conveys the same relationships.
+4. coverage: a section with 3+ paragraphs and no visual or table either gains
+   one or carries a one-line, content-specific reason; a document-level "no
+   visual fits" excuse fails the gate, and so does ornamental content added
+   just to satisfy the checklist.
+5. degradation: when a blocked carrier forces a Markdown projection, project
+   the same visuals (mermaid fences / Markdown tables); a prose-only fallback
+   fails the gate. State remaining limits after readback.
 ## Core format (PKF v1.1 strict)
@@ -150,9 +171,10 @@ reports plan visuals in the outline, never decorate afterwards:
 | Part-to-whole (share of count/risk/effort) | pie chart | `<prismer-data view="chart-pie">` |
 | Maturity/phases/gates | flowchart or table | `<prismer-diagram>` / table |
-A report with ≥3 major sections and zero visuals is a smell — justify prose-only in one
-sentence or add the missing visual; never duplicate (chart OR table OR prose enumeration);
-every caption states the takeaway, not the mechanics, and prose carries interpretation only.
+A report with ≥3 major sections and zero visuals is a smell — add the missing visual, or
+justify per section with a content-specific line; a document-level excuse fails the review
+gate. Never duplicate (chart OR table OR prose enumeration); every caption states the
+takeaway, not the mechanics, and prose carries interpretation only.
 Load `pkf-svg` for visual planning, widget composition, accessibility, and quality review;
 it owns visual/SVG grammar, this skill only routes the carrier. Simple diagrams stay on
@@ -187,7 +209,7 @@ HTML/prose, or a reviewed static asset. Do not hand-roll free SVG.
   `PKF_EXAMPLE_MIXED` — all in `src/lib/pkf/examples.ts` (`PKF_EXAMPLE_CAPABILITIES`).
   AI text-to-image output is a reviewed PNG asset with a resolved scoped URI, never an inline substitute or hand-drawn SVG.
 - `<prismer-model format="primitives" caption="…">`: declarative `box|sphere|cylinder|torus|plane`
-  JSON, ≤50 objects, zero script; renders as a static frame today.
+  JSON, ≤50 objects, zero script; live WebGL (drag-orbit, ± / Ctrl⌘+wheel zoom) + static isometric fallback.
 ## Interactive content: widgets first, harness only for custom JS

package/built-in-skills/prismer-airtable/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2025 Nous Research
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/built-in-skills/prismer-airtable/NOTICE.md ADDED Viewed

@@ -0,0 +1,11 @@
+# Source and modifications
+Derived from Hermes Agent skills/productivity/airtable, commit
+1a1f4a59e252e1dc0137e7b2e7bcc8b0381d19c4. Upstream authors remain credited
+in SKILL.md. The MIT license is included in LICENSE.
+Prismer adaptation: unique slug/native replacement, scoped execution and
+authorization, corrected resource/API instructions and local safety helpers.
+See docs/bugfix223/implementation-productivity.md in the source repository
+for offline evidence and untested live integrations. Dependencies and service
+data retain their own licenses; this notice does not relicense them.