@baravak/risloo-profile-cli 4.77.0 → 4.82.0

package/.claude/skills/create-profile/SKILL.md

@@ -24,6 +24,42 @@ Ask for the relevant inputs:
 
 Then **ask for the designer's Figma comments** — thresholds, coefficients, conditional behavior, spacing rules, and other implementation notes. The Figma MCP / SVG / HTML do **not** contain comments, and these specs usually live only there. Don't start coding until you have them.
 
+### Figma MCP budget discipline — fetch the whole artifact, not pieces
+
+Figma MCP read calls are **rate limited per plan and seat**, and the cheap tiers are brutal (a View/Collab seat, or any seat on a Starter plan, gets **6 calls per month**; a Dev/Full seat on Professional gets 200/day, 10/min). Running out mid-task strands the work. So treat every read call as expensive and design for **maximum data per request**.
+
+Rules:
+
+1. **Download the complete artifact set up front — source, SVG, and PNG — then work locally.** Do not drip-feed one layer per call. Prefer `download_assets` on the **Chart** node: one call returns the whole-node export plus the vector SVGs of its subtree. Add `get_metadata` on the same node for the layer tree with exact `x/y/width/height`. Those two calls plus one `get_screenshot` give you geometry, vectors, and the visual reference for a whole page.
+2. **Asset URLs cost nothing.** `get_design_context` on a vector-heavy layer returns an `<img src="…svg">` asset URL instead of code, and `get_screenshot` returns a PNG URL. Downloading those with `curl` does **not** consume quota. Always pull the file and read it locally rather than making another MCP call.
+3. **Never call `get_design_context` on a repeated component instance more than once.** A dotted-column or dash-ruler instance can expand to hundreds of nodes, burning a call and flooding context. Sample **one** atom for its style, then derive the repetition from `get_metadata` sizes and the pitch arithmetic.
+4. **Answer remaining questions from the downloaded PNG/SVG, not from Figma.** Exact colors, tick pitch, mirroring, and alignment are all measurable locally (e.g. sample pixels with Python/PIL, grep the SVG for `stroke=`/`fill=`). Go back to MCP only for text content and semantics that the outlined SVG genuinely cannot carry.
+5. **Batch the calls you do need in one message** so they run in parallel and stay inside the per-minute cap; keep a batch at or below the seat's per-minute limit.
+6. **Check the budget before a big pull.** `whoami` is exempt from rate limits and reports every plan and seat — use it when a call fails or before planning a large fetch. On a limit error, stop and tell the user which seat/plan is capping, rather than retrying.
+7. **If the quota is exhausted, ask the user to export the files** (Chart SVG + PNG) instead of waiting — that path costs zero calls and the SVG is authoritative for color and geometry anyway.
+
+#### Access tiers and which tools are metered
+
+| Seat | Starter | Professional | Organization | Enterprise |
+|---|---|---|---|---|
+| View, Collab | 6 / month | 6 / month | 6 / month | 6 / month |
+| Dev, Full | 6 / month | 200 / day, 10 / min | 200 / day, 15 / min | 600 / day, 20 / min |
+
+- **Metered:** every tool that *reads* from Figma — `get_design_context`, `get_metadata`, `get_screenshot`, `get_variable_defs`, `download_assets`, and the rest.
+- **Exempt:** `whoami`, `generate_figma_design`, `add_code_connect_map`, and other write-to-Figma tools. Reading MCP **resources** (`skill://…`, `file://figma/docs/…`) is also not metered.
+- Quota follows the **plan that owns the file**, not the user's best seat. A user with a Full seat on their own Starter team and a View seat on the team that owns the design still gets 6/month for that design. `whoami` returns every plan with its `tier` and `seat`, plus the plan key — the plan key also appears in the rate-limit error URL, which identifies exactly which plan is capping.
+- The fix is usually a **seat** upgrade (View → Dev/Full) on the owning team, not a plan upgrade. Report that distinction to the user instead of suggesting they buy a bigger plan.
+
+### Recommended one-shot fetch sequence for a new page
+
+For each Chart node, in a single batched message:
+
+1. `get_metadata` — the layer tree with exact `x/y/width/height` for every node. This is the geometry ledger's backbone.
+2. `download_assets` with `defaultFormat: "svg"` — returns a URL for the whole-node vector export plus the subtree's SVG assets.
+3. `get_screenshot` at a `maxDimension` at least equal to the Chart's natural width — the visual acceptance reference.
+
+Then `curl` all returned URLs (free) and do the rest locally: read the export SVG for exact colors, strokes, radii, gradients and paint order; read the metadata for layout boxes and text-node dimensions; compare renders against the PNG. Only text **content** needs a further call, and `get_metadata` already carries it in the layer `name` for text nodes.
+
 Do not select one design artifact and ignore the others. Establish an authority table for the current task:
 
 - **PNG** — final visual acceptance target, including visible orientation, wrapping, cropping, alignment, and composition.

package/.github/workflows/publish.yml

@@ -0,0 +1,70 @@
+name: Publish to npm
+
+# Releases are driven by a tag:
+#
+#   npm version <patch|minor|major>
+#   git push --follow-tags
+#
+# No npm token is involved. The job authenticates to the registry with a
+# short-lived OIDC credential issued to this workflow (trusted publishing),
+# which is what `id-token: write` below grants. The registry must be told to
+# trust this repository + workflow filename in the package's settings.
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org
+          cache: npm
+
+      # Trusted publishing needs npm 11.5.1+. The npm bundled with Node usually
+      # already satisfies that, so only reach for the network when it does not
+      # — an unconditional global install is a needless failure point.
+      - name: Ensure npm supports trusted publishing
+        run: |
+          need=11.5.1
+          have="$(npm --version)"
+          if [ "$(printf '%s\n%s\n' "$need" "$have" | sort -V | head -n1)" = "$need" ]; then
+            echo "npm $have satisfies >= $need"
+          else
+            echo "npm $have is older than $need, upgrading"
+            for attempt in 1 2 3; do
+              npm install -g npm@latest && break
+              echo "attempt $attempt failed, retrying"; sleep 10
+            done
+          fi
+          npm --version
+
+      - run: npm ci --fetch-retries=5
+
+      # sharp carries a native binary. Fail here with a clear message rather
+      # than part-way through the release.
+      - name: Smoke-check the native image pipeline
+        run: node -e "require('sharp'); console.log('sharp loaded')"
+
+      # A tag that disagrees with package.json would publish the wrong version.
+      - name: Check the tag matches package.json
+        if: github.event_name == 'push'
+        run: |
+          tag="${GITHUB_REF_NAME#v}"
+          pkg="$(node -p "require('./package.json').version")"
+          echo "tag=$tag  package.json=$pkg"
+          test "$tag" = "$pkg"
+
+      # Runs prepublishOnly (npm test) first. Provenance is attached
+      # automatically because this is a public repository.
+      - run: npm publish

package/.github/workflows/push.yml

@@ -1,14 +1,23 @@
-name: push-package
+name: CI
+
 on:
-  push
+  push:
+  pull_request:
+
 jobs:
-  build:
+  test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-node@v7
         with:
-          node-version: "16.x"
-      - run: |
-          yarn
-          yarn test
+          node-version: 24
+          cache: npm
+
+      # `npm ci` installs exactly what package-lock.json pins; the previous
+      # `yarn` step ignored that lockfile.
+      - run: npm ci
+
+      # Renders every sample in both variants.
+      - run: npm test

package/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "figma": {
+      "type": "http",
+      "url": "https://mcp.figma.com/mcp"
+    }
+  }
+}

package/AGENTS.md

@@ -44,8 +44,7 @@ risloo-extractor-app/
 │   └── publish/
 │       ├── json/profiles/       # Template JSON per sample
 │       ├── json/gift/           # Gift template data
-│       ├── test.js              # Auto-test all samples
-│       └── bot.js               # Post-publish automation
+│       └── test.js              # Auto-test all samples
 ├── views/
 │   ├── profiles/samples/        # Handlebars SVG templates (.hbs)
 │   └── gift.hbs
@@ -387,7 +386,7 @@ If several local coordinate patches accumulate, stop. Re-establish the coordinat
 | Dates | Moment.js + moment-jalaali (Persian calendar) |
 | QR codes | qrcode |
 | File watching | Chokidar |
-| Package manager | Yarn |
+| Package manager | npm (`package-lock.json` is the lockfile) |
 | Design source | Figma (via MCP) |
 
 ---
@@ -405,9 +404,17 @@ If several local coordinate patches accumulate, stop. Re-establish the coordinat
 
 ## Publishing
 
+Releases go through GitHub Actions via npm **trusted publishing** (OIDC) — there
+is no npm token anywhere, local or in secrets. Tag the release and push it; the
+`.github/workflows/publish.yml` job publishes it.
+
 ```bash
-npm version <patch|minor|major>
-npm publish
-# prepublishOnly: npm test
-# postpublish: npm run bot
+npm version <patch|minor|major>   # bumps package.json and creates the vX.Y.Z tag
+git push --follow-tags            # pushing the tag triggers the release
+# prepublishOnly: npm test — runs inside the job before the registry is touched
 ```
+
+The job refuses to publish if the tag and `package.json` version disagree.
+Publishing from a laptop with `npm publish` is not expected to work: npm
+removed non-expiring tokens, and the package is configured to trust this
+workflow instead.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baravak/risloo-profile-cli",
-  "version": "4.77.0",
+  "version": "4.82.0",
   "description": "**Risloo Profile CLI** is a library for creating profiles, reports and sheets for *psychological* samples.",
   "main": "bin/risloo.js",
   "publishConfig": {
@@ -10,10 +10,8 @@
     "risloo": "bin/risloo.js"
   },
   "scripts": {
-    "bot": "node ./src/publish/bot.js",
     "test": "node ./src/publish/test.js",
     "prepublishOnly": "npm test",
-    "postpublish": "npm run bot",
     "start": "node app"
   },
   "repository": {
@@ -26,8 +24,6 @@
     "chalk": "^4.1.2",
     "chokidar": "^3.5.3",
     "commander": "^8.3.0",
-    "dotenv": "^16.0.0",
-    "form-data": "^4.0.0",
     "handlebars": "^4.7.7",
     "moment": "^2.29.1",
     "moment-jalaali": "^0.9.2",
@@ -40,4 +36,4 @@
     "url": "https://github.com/baravak/risloo-extractor-app/issues"
   },
   "homepage": "https://github.com/baravak/risloo-extractor-app#readme"
-}
+}

package/src/samples/BSSI93.js

@@ -58,14 +58,44 @@ class BSSI93 extends Profile {
     const end = FS.toRadians(180); //   100% at left (9 o'clock)
     total.zeta = total.p * (end - start) + start; // clockwise 270° sweep
 
-    // --- Factors (vertical bars, left → right) ---
-    // Domain names are drawn under each bar; 2-line ones split as in the design.
-    const lines = [["تمایل به مرگ"], ["آمادگی برای", "خودکشی"], ["تمایل به", "خودکشی واقعی"]];
-    const factors = [packItem(s[2], s[3]), packItem(s[4], s[5]), packItem(s[6], s[7])].map((f, i) => ({
-      ...f,
-      cx: 120 + i * 100, // bar centres: 120, 220, 320
-      trackLeft: 106 + i * 100, // track/bar left edges: 106, 206, 306
-      lines: lines[i],
+    // --- Factors (visual order, left → right) ---
+    // The scientific score keys stay unchanged. The design places the intent
+    // score in the middle slot and the preparation score in the right slot.
+    const factorSpecs = [
+      {
+        raw: s[2],
+        percentage: s[3],
+        cx: 120,
+        trackLeft: 106,
+        scoreX: 120.5,
+        lines: [{ text: "تمایل به مرگ", x: 120, y: 351.5 }],
+      },
+      {
+        raw: s[6],
+        percentage: s[7],
+        cx: 220,
+        trackLeft: 206,
+        scoreX: 221.5,
+        lines: [
+          { text: "آمادگی برای", x: 219.5, y: 351.5 },
+          { text: "خودکشی", x: 219, y: 368 },
+        ],
+      },
+      {
+        raw: s[4],
+        percentage: s[5],
+        cx: 320,
+        trackLeft: 306,
+        scoreX: 322,
+        lines: [
+          { text: "تمایل به", x: 322, y: 352.5 },
+          { text: "خودکشی واقعی", x: 322, y: 368 },
+        ],
+      },
+    ];
+    const factors = factorSpecs.map(({ raw, percentage, ...geometry }) => ({
+      ...packItem(raw, percentage),
+      ...geometry,
     }));
 
     return [{ total, factors }];

package/src/samples/NEO93.js

@@ -52,12 +52,55 @@ for (const { key } of DOMAINS) {
   }
 }
 
+// Page 4 (profile sheet). The Chart layer is 885 × 649; every number below is
+// measured from it, so the shared NEO_sheet partial stays free of profile logic.
+const SHEET_GROUP_X = [54, 175, 317, 459, 601, 743];
+const SHEET_COL_STEP = 21;
+const SHEET_COL_HALF = 6.5;
+
+// 0 % sits on the bottom gridline, 100 % on the top one, 500 px apart.
+const SHEET_ZERO_Y = 632;
+const SHEET_PX_PER_PERCENT = 5;
+
+const SHEET_DOMAIN_STROKE = "#4338CA";
+const SHEET_FACET_STROKE = "#334155";
+
 function clamp(value, min, max) {
   const number = Number(value);
   if (!Number.isFinite(number)) return min;
   return Math.min(max, Math.max(min, number));
 }
 
+function sheetColumns() {
+  const columns = DOMAINS.map(({ fa, letter }, index) => ({
+    cx: SHEET_GROUP_X[0] + SHEET_COL_HALF + index * SHEET_COL_STEP,
+    code: letter,
+    fa,
+    domain: true,
+  }));
+
+  DOMAINS.forEach(({ key, letter }, groupIndex) => {
+    FACET_NAMES[key].forEach((fa, index) => {
+      columns.push({
+        cx: SHEET_GROUP_X[groupIndex + 1] + SHEET_COL_HALF + index * SHEET_COL_STEP,
+        code: `${letter}${index + 1}`,
+        fa,
+        domain: false,
+      });
+    });
+  });
+
+  return columns;
+}
+
+// One dash per axis unit; every `accentEvery`-th one is the dark, readable tick.
+function sheetDashes(top, pitch, count, accentEvery) {
+  return Array.from({ length: count }, (unused, index) => ({
+    y: top + index * pitch,
+    dark: index % accentEvery === 0,
+  }));
+}
+
 function layoutIndicators(indicators) {
   let start = 0;
 
@@ -73,11 +116,12 @@ function layoutIndicators(indicators) {
 }
 
 class NEO93 extends Profile {
-  static pages = 3;
+  static pages = 4;
 
   static partials = {
     NEO_main: "NEO_main.hbs",
     NEO_long_facets: "NEO_long_facets.hbs",
+    NEO_sheet: "NEO_sheet.hbs",
   };
 
   labels = {
@@ -99,26 +143,35 @@ class NEO93 extends Profile {
     },
     profile: {
       get dimensions() {
-        const [page1, page2, page3] = this.padding;
+        const [page1, page2, page3, page4] = this.padding;
         return [
           {
-            width: 800 + 2 * page1.x,
-            height: 674 + 2 * page1.y,
+            width: 885 + 2 * page1.x,
+            height: 649 + 2 * page1.y,
           },
           {
-            width: 811 + 2 * page2.x,
-            height: 662 + 2 * page2.y,
+            width: 800 + 2 * page2.x,
+            height: 674 + 2 * page2.y,
           },
           {
             width: 811 + 2 * page3.x,
-            height: 458 + 2 * page3.y,
+            height: 662 + 2 * page3.y,
+          },
+          {
+            width: 811 + 2 * page4.x,
+            height: 458 + 2 * page4.y,
           },
         ];
       },
+      // Padding is the Chart's inset inside the 943 × 754 design page *minus*
+      // the 20 px the layout already owns on every side. Every page therefore
+      // resolves to 903 × 714 — the exact with-sidebar drawing area — and
+      // renders at scale 1 instead of being shrunk to fit.
       padding: [
-        { x: 71.5, y: 40 },
-        { x: 66, y: 46 },
-        { x: 66, y: 148 },
+        { x: 9, y: 32.5 },
+        { x: 51.5, y: 20 },
+        { x: 46, y: 26 },
+        { x: 46, y: 128 },
       ],
     },
     labels: Object.values(this.labels),
@@ -247,11 +300,77 @@ class NEO93 extends Profile {
       };
     });
 
+    const sheetCols = sheetColumns();
+    const sheetY = (percentage) => SHEET_ZERO_Y - SHEET_PX_PER_PERCENT * clamp(percentage, 0, 100);
+    const polyline = (cols, values) => values.map((value, index) => `${cols[index].cx},${sheetY(value)}`).join(" ");
+
+    const series = [
+      { stroke: SHEET_DOMAIN_STROKE, points: polyline(sheetCols.slice(0, 5), items.map((item) => item.percentage)) },
+      ...blocks.map((block, groupIndex) => ({
+        stroke: SHEET_FACET_STROKE,
+        points: polyline(
+          sheetCols.slice(5 + groupIndex * 6, 11 + groupIndex * 6),
+          block.facets.map((facet) => facet.percentage)
+        ),
+      })),
+    ];
+
+    // The profile sheet opens the report; the bar pages follow it.
     return [
       {
         ...sharedContext,
         page: 1,
-        titleAppend: titleAppend(1),
+        titleAppend: " - کلاسیک",
+        columns: sheetCols,
+        series,
+        sheet: {
+          grid: {
+            x: 31,
+            w: 854,
+            ys: [
+              { y: 131, faint: false },
+              { y: 231, faint: true },
+              { y: 331, faint: true },
+              { y: 431, faint: true },
+              { y: 531, faint: true },
+              { y: 631, faint: false },
+            ],
+          },
+          plot: { top: 132, bottom: 632 },
+          dot: { pitch: 5, accentPitch: 20, light: "#F1F5F9", accent: "#94A3B8" },
+          tick: { top: 121, h: 10 },
+          rail: {
+            dashLeftX: 36,
+            dashRightX: 873,
+            w: 6,
+            ruleLeftX: 45.5,
+            ruleRightX: 868.5,
+            ruleW: 1,
+            ruleTop: 131,
+            ruleH: 502,
+            dark: "#64748B",
+            light: "white",
+          },
+          dashes: sheetDashes(132, 5, 101, 4),
+          numberX: 24,
+          numbers: [
+            { y: 132, text: "100 ٪" },
+            { y: 232, text: "80 ٪" },
+            { y: 332, text: "60 ٪" },
+            { y: 432, text: "40 ٪" },
+            { y: 532, text: "20 ٪" },
+            { y: 632, text: "0" },
+          ],
+          levelX: 0,
+          levels: [],
+          titleBottomY: 115,
+          codeY: 648,
+        },
+      },
+      {
+        ...sharedContext,
+        page: 2,
+        titleAppend: titleAppend(2),
         items,
         redErrors: layoutIndicators(redErrors),
         yellowErrors: layoutIndicators(yellowErrors),
@@ -260,15 +379,15 @@ class NEO93 extends Profile {
       },
       {
         ...sharedContext,
-        page: 2,
-        titleAppend: titleAppend(2),
+        page: 3,
+        titleAppend: titleAppend(3),
         blocks: blocks.slice(0, 3),
         gridBottom: 658.5,
       },
       {
         ...sharedContext,
-        page: 3,
-        titleAppend: titleAppend(3),
+        page: 4,
+        titleAppend: titleAppend(4),
         blocks: blocks.slice(3, 5),
         gridBottom: 454.5,
       },

package/src/samples/NEO9A.js

@@ -66,9 +66,13 @@ class NEO9A extends Profile {
           height: 674 + 2 * this.padding.y,
         };
       },
+      // Padding is the Chart's inset inside the 943 × 754 design page *minus*
+      // the 20 px the layout already owns on every side, so the page resolves
+      // to 903 × 714 — the exact with-sidebar drawing area — and renders at
+      // scale 1 instead of being shrunk to fit.
       padding: {
-        x: 71.5,
-        y: 40,
+        x: 51.5,
+        y: 20,
       },
     },
     labels: Object.values(this.labels),

package/src/samples/NEO9Q.js

@@ -52,12 +52,60 @@ for (const { key } of DOMAINS) {
   }
 }
 
+// Page 4 (profile sheet). The Chart layer is 878 × 704; every number below is
+// measured from it, so the shared NEO_sheet partial stays free of profile logic.
+const SHEET_GROUP_X = [47, 168, 310, 452, 594, 736];
+const SHEET_COL_STEP = 21;
+const SHEET_COL_HALF = 6.5;
+
+// The T axis runs 20…80 at a flat 9 px per point: T 20 on the bottom gridline,
+// T 80 on the top one. `_lookup` floors at 20 and the norm tables top out at 80,
+// but the clamp also keeps a missing key (which `?? 0` turns into 0) on the sheet.
+const SHEET_MIN_T = 20;
+const SHEET_MAX_T = 80;
+const SHEET_MIN_T_Y = 687;
+const SHEET_PX_PER_T = 9;
+
+const SHEET_DOMAIN_STROKE = "#4338CA";
+const SHEET_FACET_STROKE = "#334155";
+
 function clamp(value, min, max) {
   const number = Number(value);
   if (!Number.isFinite(number)) return min;
   return Math.min(max, Math.max(min, number));
 }
 
+function sheetColumns() {
+  const columns = DOMAINS.map(({ fa, letter }, index) => ({
+    cx: SHEET_GROUP_X[0] + SHEET_COL_HALF + index * SHEET_COL_STEP,
+    code: letter,
+    fa,
+    domain: true,
+  }));
+
+  DOMAINS.forEach(({ key, letter }, groupIndex) => {
+    FACET_NAMES[key].forEach((fa, index) => {
+      columns.push({
+        cx: SHEET_GROUP_X[groupIndex + 1] + SHEET_COL_HALF + index * SHEET_COL_STEP,
+        code: `${letter}${index + 1}`,
+        fa,
+        domain: false,
+      });
+    });
+  });
+
+  return columns;
+}
+
+// One dash per T point; every `accentEvery`-th one is dark — on this form that
+// marks the even T values, which are the only ones the norm tables can produce.
+function sheetDashes(top, pitch, count, accentEvery) {
+  return Array.from({ length: count }, (unused, index) => ({
+    y: top + index * pitch,
+    dark: index % accentEvery === 0,
+  }));
+}
+
 function layoutIndicators(indicators) {
   let start = 0;
 
@@ -73,11 +121,12 @@ function layoutIndicators(indicators) {
 }
 
 class NEO9Q extends Profile {
-  static pages = 3;
+  static pages = 4;
 
   static partials = {
     NEO_main: "NEO_main.hbs",
     NEO_long_facets: "NEO_long_facets.hbs",
+    NEO_sheet: "NEO_sheet.hbs",
   };
 
   labels = {
@@ -99,26 +148,35 @@ class NEO9Q extends Profile {
     },
     profile: {
       get dimensions() {
-        const [page1, page2, page3] = this.padding;
+        const [page1, page2, page3, page4] = this.padding;
         return [
           {
-            width: 800 + 2 * page1.x,
-            height: 674 + 2 * page1.y,
+            width: 878 + 2 * page1.x,
+            height: 704 + 2 * page1.y,
           },
           {
-            width: 811 + 2 * page2.x,
-            height: 668 + 2 * page2.y,
+            width: 800 + 2 * page2.x,
+            height: 674 + 2 * page2.y,
           },
           {
             width: 811 + 2 * page3.x,
-            height: 464 + 2 * page3.y,
+            height: 668 + 2 * page3.y,
+          },
+          {
+            width: 811 + 2 * page4.x,
+            height: 464 + 2 * page4.y,
           },
         ];
       },
+      // Padding is the Chart's inset inside the 943 × 754 design page *minus*
+      // the 20 px the layout already owns on every side. Every page therefore
+      // resolves to 903 × 714 — the exact with-sidebar drawing area — and
+      // renders at scale 1 instead of being shrunk to fit.
       padding: [
-        { x: 71.5, y: 40 },
-        { x: 66, y: 43 },
-        { x: 66, y: 145 },
+        { x: 12.5, y: 5 },
+        { x: 51.5, y: 20 },
+        { x: 46, y: 23 },
+        { x: 46, y: 125 },
       ],
     },
     labels: Object.values(this.labels),
@@ -249,11 +307,84 @@ class NEO9Q extends Profile {
       };
     });
 
+    const sheetCols = sheetColumns();
+    const sheetY = (t) => SHEET_MIN_T_Y - SHEET_PX_PER_T * (clamp(t, SHEET_MIN_T, SHEET_MAX_T) - SHEET_MIN_T);
+    const polyline = (cols, values) => values.map((value, index) => `${cols[index].cx},${sheetY(value)}`).join(" ");
+
+    const series = [
+      { stroke: SHEET_DOMAIN_STROKE, points: polyline(sheetCols.slice(0, 5), items.map((item) => item.tScore)) },
+      ...blocks.map((block, groupIndex) => ({
+        stroke: SHEET_FACET_STROKE,
+        points: polyline(
+          sheetCols.slice(5 + groupIndex * 6, 11 + groupIndex * 6),
+          block.facets.map((facet) => facet.tScore)
+        ),
+      })),
+    ];
+
+    // The profile sheet opens the report; the bar pages follow it.
     return [
       {
         ...sharedContext,
         page: 1,
-        titleAppend: titleAppend(1),
+        titleAppend: " - کلاسیک",
+        columns: sheetCols,
+        series,
+        sheet: {
+          grid: {
+            x: 24,
+            w: 854,
+            ys: [
+              { y: 146, faint: false },
+              { y: 281, faint: true },
+              { y: 371, faint: true },
+              { y: 461, faint: true },
+              { y: 551, faint: true },
+              { y: 686, faint: false },
+            ],
+          },
+          plot: { top: 147, bottom: 687 },
+          dot: { pitch: 9, accentPitch: 18, light: "#F1F5F9", accent: "#94A3B8" },
+          tick: { top: 136, h: 10 },
+          rail: {
+            dashLeftX: 29,
+            dashRightX: 866,
+            w: 6,
+            ruleLeftX: 38,
+            ruleRightX: 861,
+            ruleW: 2,
+            ruleTop: 146,
+            ruleH: 542,
+            dark: "#64748B",
+            light: "#CBD5E1",
+          },
+          dashes: sheetDashes(147, 9, 61, 2),
+          numberX: 17,
+          numbers: [
+            { y: 147, text: "80" },
+            { y: 282, text: "65" },
+            { y: 372, text: "55" },
+            { y: 462, text: "45" },
+            { y: 552, text: "35" },
+            { y: 687, text: "20" },
+          ],
+          levelX: 9.9,
+          // Each band label sits midway between the two gridlines that bound it.
+          levels: [
+            { y: 214.5, text: LEVELS[5] },
+            { y: 327, text: LEVELS[4] },
+            { y: 417, text: LEVELS[3] },
+            { y: 507, text: LEVELS[2] },
+            { y: 619.5, text: LEVELS[1] },
+          ],
+          titleBottomY: 130,
+          codeY: 703,
+        },
+      },
+      {
+        ...sharedContext,
+        page: 2,
+        titleAppend: titleAppend(2),
         items,
         redErrors: layoutIndicators(redErrors),
         yellowErrors: layoutIndicators(yellowErrors),
@@ -262,15 +393,15 @@ class NEO9Q extends Profile {
       },
       {
         ...sharedContext,
-        page: 2,
-        titleAppend: titleAppend(2),
+        page: 3,
+        titleAppend: titleAppend(3),
         blocks: blocks.slice(0, 3),
         gridBottom: 664.5,
       },
       {
         ...sharedContext,
-        page: 3,
-        titleAppend: titleAppend(3),
+        page: 4,
+        titleAppend: titleAppend(4),
         blocks: blocks.slice(3, 5),
         gridBottom: 460.5,
       },

package/src/samples/NEO9V.js

@@ -132,9 +132,13 @@ class NEO9V extends Profile {
           },
         ];
       },
+      // Padding is the Chart's inset inside the 943 × 754 design page *minus*
+      // the 20 px the layout already owns on every side. Both pages therefore
+      // resolve to 903 × 714 — the exact with-sidebar drawing area — and
+      // render at scale 1 instead of being shrunk to fit.
       padding: [
-        { x: 71, y: 40 },
-        { x: 91.5, y: 46 },
+        { x: 51, y: 20 },
+        { x: 71.5, y: 26 },
       ],
     },
     labels: Object.values(this.labels),

package/views/profiles/NEO_sheet.hbs

@@ -0,0 +1,70 @@
+{{!--
+  NEO profile sheet (نیم‌رخ): 35 dotted columns — the 5 domains, then 6 groups of
+  6 facets — over a horizontal gridline scale, with rotated titles above, latin
+  codes below, and one polyline per group.
+
+  Every coordinate arrives from the controller; nothing is derived here, so the
+  percentage sheet and the T-score sheet share this file without a variant flag.
+
+    padding             {x, y}                     page padding owned by the layout
+    sheet.grid          {x, w, ys: [{y, faint}]}   gridline rects, y = rect top edge
+    sheet.plot          {top, bottom}              dot-column endpoints (gridline centres)
+    sheet.dot           {pitch, accentPitch, light, accent}
+    sheet.tick          {top, h}                   column ticks above the top gridline
+    sheet.rail          {dashLeftX, dashRightX, w, ruleLeftX, ruleRightX, ruleW,
+                         ruleTop, ruleH, dark, light, dashes: [{y, dark}]}
+    sheet.numberX       right edge the axis numbers align to
+    sheet.numbers       [{y, text}]                axis numbers, y = gridline centre
+    sheet.levelX        centre guide of the rotated level words
+    sheet.levels        [{y, text}]                rotated level words, may be empty
+    sheet.titleBottomY  guide the rotated titles grow upward from
+    sheet.codeY         baseline of the latin codes
+    columns             [{cx, code, fa, domain}]   35 entries, design draw order
+    series              [{points, stroke}]         one polyline per group
+
+  Paint order mirrors the design export: codes, titles, dots, rails, numbers,
+  ticks, gridlines, result lines.
+--}}
+<g transform="translate({{padding.x}}, {{padding.y}})">
+  {{#each columns as |col|}}
+    <text class="eng-font" x="{{col.cx}}" y="{{../sheet.codeY}}" direction="ltr" font-size="10" font-weight="400" fill="#94A3B8" text-anchor="middle">{{col.code}}</text>
+  {{/each}}
+
+  {{#each columns as |col|}}
+    <text x="{{col.cx}}" y="{{../sheet.titleBottomY}}" transform="rotate(-90 {{col.cx}} {{../sheet.titleBottomY}})" direction="ltr" font-size="12" font-weight="{{ternary col.domain 600 400}}" fill="{{ternary col.domain '#4338CA' '#334155'}}" text-anchor="start" dy=".35em"><tspan class="eng-font">{{col.code}}</tspan> - {{col.fa}}</text>
+  {{/each}}
+
+  {{#each columns as |col|}}
+    <line x1="{{col.cx}}" y1="{{../sheet.plot.top}}" x2="{{col.cx}}" y2="{{../sheet.plot.bottom}}" stroke="{{../sheet.dot.light}}" stroke-width="2" stroke-linecap="round" stroke-dasharray="0 {{../sheet.dot.pitch}}"/>
+    <line x1="{{col.cx}}" y1="{{../sheet.plot.top}}" x2="{{col.cx}}" y2="{{../sheet.plot.bottom}}" stroke="{{../sheet.dot.accent}}" stroke-width="2" stroke-linecap="round" stroke-dasharray="0 {{../sheet.dot.accentPitch}}"/>
+  {{/each}}
+
+  {{#each sheet.dashes as |dash|}}
+    <line x1="{{math ../sheet.rail.dashLeftX '+' 1}}" y1="{{dash.y}}" x2="{{math ../sheet.rail.dashLeftX '+' (math ../sheet.rail.w '-' 1)}}" y2="{{dash.y}}" stroke="{{ternary dash.dark ../sheet.rail.dark ../sheet.rail.light}}" stroke-width="2" stroke-linecap="round"/>
+    <line x1="{{math ../sheet.rail.dashRightX '+' 1}}" y1="{{dash.y}}" x2="{{math ../sheet.rail.dashRightX '+' (math ../sheet.rail.w '-' 1)}}" y2="{{dash.y}}" stroke="{{ternary dash.dark ../sheet.rail.dark ../sheet.rail.light}}" stroke-width="2" stroke-linecap="round"/>
+  {{/each}}
+  <rect x="{{sheet.rail.ruleLeftX}}" y="{{sheet.rail.ruleTop}}" width="{{sheet.rail.ruleW}}" height="{{sheet.rail.ruleH}}" fill="{{sheet.rail.dark}}"/>
+  <rect x="{{sheet.rail.ruleRightX}}" y="{{sheet.rail.ruleTop}}" width="{{sheet.rail.ruleW}}" height="{{sheet.rail.ruleH}}" fill="{{sheet.rail.dark}}"/>
+
+  {{#each sheet.numbers as |number|}}
+    <text x="{{../sheet.numberX}}" y="{{number.y}}" dy=".3em" font-size="12" font-weight="400" fill="#64748B" text-anchor="start">{{number.text}}</text>
+  {{/each}}
+
+  {{#each sheet.levels as |level|}}
+    <text x="{{../sheet.levelX}}" y="{{level.y}}" transform="rotate(-90 {{../sheet.levelX}} {{level.y}})" font-size="12" font-weight="400" fill="#94A3B8" text-anchor="middle" dy=".35em">{{level.text}}</text>
+  {{/each}}
+
+  {{#each columns as |col|}}
+    <g transform="translate({{math col.cx '-' 1}}, {{../sheet.tick.top}})">
+      {{bar 2 ../sheet.tick.h (object tl=1 tr=1 bl=0 br=0) (toRad 0) fill=(ternary col.domain '#4338CA' '#64748B')}}
+    </g>
+  {{/each}}
+
+  {{#each sheet.grid.ys as |line|}}
+    <rect x="{{../sheet.grid.x}}" y="{{line.y}}" width="{{../sheet.grid.w}}" height="2" rx="1" fill="#94A3B8"{{#if line.faint}} fill-opacity="0.25"{{/if}}/>
+  {{/each}}
+
+  {{#each series as |line|}}
+    <polyline points="{{line.points}}" fill="none" stroke="{{line.stroke}}" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+  {{/each}}
+</g>

package/views/profiles/samples/BSSI93.hbs

@@ -47,8 +47,8 @@
     <line x1="69.5" y1="102.5" x2="408.5" y2="102.5" stroke="#E2E8F0" stroke-linecap="round" stroke-dasharray="6 6"/>
     <line x1="69.5" y1="177.5" x2="408.5" y2="177.5" stroke="#E2E8F0" stroke-linecap="round" stroke-dasharray="6 6"/>
     <line x1="69.5" y1="252.5" x2="408.5" y2="252.5" stroke="#E2E8F0" stroke-linecap="round" stroke-dasharray="6 6"/>
-    <text x="53" y="27.5" text-anchor="end" dy=".85em" font-size="12" fill="#94A3B8" direction="ltr">٪ 100</text>
-    <text x="53" y="177.5" text-anchor="end" dy=".35em" font-size="12" fill="#94A3B8" direction="ltr">٪ 50</text>
+    <text x="53" y="25.5" text-anchor="end" dy=".85em" font-size="12" fill="#94A3B8" direction="ltr">٪ 100</text>
+    <text x="53" y="175.5" text-anchor="end" dy=".35em" font-size="12" fill="#94A3B8" direction="ltr">٪ 50</text>
 
     {{! Value bars + inside/outside percentage label }}
     {{#each factors as |factor|}}
@@ -66,8 +66,8 @@
 
     {{! Domain names under each bar }}
     {{#each factors as |factor|}}
-      {{#each factor.lines as |line lineIndex|}}
-        <text x="{{factor.cx}}" y="{{math 352 '+' (math 18 '*' lineIndex)}}" text-anchor="middle" font-size="14" fill="#334155">{{line}}</text>
+      {{#each factor.lines as |line|}}
+        <text x="{{line.x}}" y="{{line.y}}" text-anchor="middle" font-size="14" fill="#334155">{{line.text}}</text>
       {{/each}}
     {{/each}}
 
@@ -77,10 +77,10 @@
     </g>
 
     {{! ===== "raw score" header row: legend + per-bar raw/max fractions ===== }}
-    <text x="38" y="9" text-anchor="start" dy=".3em" font-size="12" fill="#94A3B8">نمره خام</text>
+    <text x="38" y="7.5" text-anchor="start" dy=".3em" font-size="12" fill="#94A3B8">نمره خام</text>
     <path d="M45.5 8L52.5 8M49.5 11L52.5 8L49.5 5" stroke="#94A3B8" stroke-width="0.75" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
     {{#each factors as |factor|}}
-      <text x="{{factor.cx}}" y="9" text-anchor="middle" dy=".3em" direction="ltr"><tspan font-weight="700" font-size="16" fill="#BE185D">{{factor.mark}}</tspan><tspan font-weight="300" font-size="12" fill="#64748B"> / </tspan><tspan font-weight="400" font-size="13" fill="#64748B">{{factor.max}}</tspan></text>
+      <text x="{{factor.scoreX}}" y="9.5" text-anchor="middle" dy=".3em" direction="ltr"><tspan font-weight="700" font-size="16" fill="#BE185D">{{factor.mark}}</tspan><tspan font-weight="300" font-size="12" fill="#64748B"> / </tspan><tspan font-weight="400" font-size="13" fill="#64748B">{{factor.max}}</tspan></text>
     {{/each}}
 
     {{! ===================== Total score ring gauge ===================== }}
@@ -88,13 +88,13 @@
       {{gauge 70 49 (object tl=6 tr=6 bl=6 br=6) (object start=(toRad -90) end=(toRad 180)) false clip-path="url(#gauge-roll)" fill="#F1F5F9"}}
       {{#if total.mark}}{{gauge 70 49 (object tl=6 tr=6 bl=6 br=6) (object start=(toRad -90) end=total.zeta) false clip-path="url(#gauge-roll)" fill="url(#gaugeGrad)"}}{{/if}}
 
-      <text x="0" y="-2" text-anchor="middle" font-size="24" font-weight="600" fill="#334155" direction="ltr">٪ {{total.pct}}</text>
-      <text x="0" y="26" text-anchor="middle" font-size="15" font-weight="500" fill="#64748B">{{total.mark}} از {{total.max}}</text>
+      <text x="0" y="-4" text-anchor="middle" font-size="24" font-weight="600" fill="#334155" direction="ltr">٪ {{total.pct}}</text>
+      <text x="0" y="22" text-anchor="middle" font-size="15" font-weight="500" fill="#64748B">{{total.mark}} از {{total.max}}</text>
 
-      <text x="-60" y="-6" text-anchor="middle" font-size="14" fill="#64748B" direction="ltr">٪ 100</text>
+      <text x="-60" y="-8" text-anchor="middle" font-size="14" fill="#64748B" direction="ltr">٪ 100</text>
       <text x="-11" y="-56" text-anchor="middle" font-size="14" fill="#64748B">0</text>
 
-      <text x="0" y="104" text-anchor="middle" font-size="16" font-weight="500" fill="#475569">نمره کل</text>
+      <text x="0" y="102" text-anchor="middle" font-size="16" font-weight="500" fill="#475569">نمره کل</text>
     </g>
 
   </g>

package/views/profiles/samples/NEO93_1.hbs

@@ -1,14 +1,5 @@
 {{#> layout}}
-  {{> NEO_main
+  {{> NEO_sheet
     padding=spec.profile.padding.[0]
-    frameX=32
-    barX=111
-    rawX=627.5
-    rawCenter=645
-    rawMax=192
-    levelX=707
-    showLevels=true
-    tAxis=false
-    alertX=0
   }}
 {{/layout}}

package/views/profiles/samples/NEO93_2.hbs

@@ -1,15 +1,14 @@
 {{#> layout}}
-  {{> NEO_long_facets
+  {{> NEO_main
     padding=spec.profile.padding.[1]
-    cardY=43
-    trackW=300
-    rawX=671.5
-    rawCenter=689
-    levelX=756
-    domainChipX=68
-    domainChipW=44
-    gridTop=23.5
-    gridBottom=658.5
+    frameX=32
+    barX=111
+    rawX=627.5
+    rawCenter=645
+    rawMax=192
+    levelX=707
+    showLevels=true
     tAxis=false
+    alertX=0
   }}
 {{/layout}}

package/views/profiles/samples/NEO93_3.hbs

@@ -9,7 +9,7 @@
     domainChipX=68
     domainChipW=44
     gridTop=23.5
-    gridBottom=454.5
+    gridBottom=658.5
     tAxis=false
   }}
 {{/layout}}

package/views/profiles/samples/NEO93_4.hbs

@@ -0,0 +1,15 @@
+{{#> layout}}
+  {{> NEO_long_facets
+    padding=spec.profile.padding.[3]
+    cardY=43
+    trackW=300
+    rawX=671.5
+    rawCenter=689
+    levelX=756
+    domainChipX=68
+    domainChipW=44
+    gridTop=23.5
+    gridBottom=454.5
+    tAxis=false
+  }}
+{{/layout}}

package/views/profiles/samples/NEO9Q_1.hbs

@@ -1,13 +1,5 @@
 {{#> layout}}
-  {{> NEO_main
+  {{> NEO_sheet
     padding=spec.profile.padding.[0]
-    frameX=62
-    barX=123
-    rawX=639.5
-    rawCenter=657
-    rawMax=192
-    showLevels=false
-    tAxis=true
-    alertX=0
   }}
 {{/layout}}

package/views/profiles/samples/NEO9Q_2.hbs

@@ -1,14 +1,13 @@
 {{#> layout}}
-  {{> NEO_long_facets
+  {{> NEO_main
     padding=spec.profile.padding.[1]
-    cardY=49
-    trackW=380
-    rawX=759.5
-    rawCenter=777
-    domainChipX=70
-    domainChipW=40
-    gridTop=29.5
-    gridBottom=664.5
+    frameX=62
+    barX=123
+    rawX=639.5
+    rawCenter=657
+    rawMax=192
+    showLevels=false
     tAxis=true
+    alertX=0
   }}
 {{/layout}}

package/views/profiles/samples/NEO9Q_3.hbs

@@ -8,7 +8,7 @@
     domainChipX=70
     domainChipW=40
     gridTop=29.5
-    gridBottom=460.5
+    gridBottom=664.5
     tAxis=true
   }}
 {{/layout}}

package/views/profiles/samples/NEO9Q_4.hbs

@@ -0,0 +1,14 @@
+{{#> layout}}
+  {{> NEO_long_facets
+    padding=spec.profile.padding.[3]
+    cardY=49
+    trackW=380
+    rawX=759.5
+    rawCenter=777
+    domainChipX=70
+    domainChipW=40
+    gridTop=29.5
+    gridBottom=460.5
+    tAxis=true
+  }}
+{{/layout}}

package/.claude/settings.local.json

@@ -1,7 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(*)"
-    ]
-  }
-}

package/src/publish/bot.js

@@ -1,91 +0,0 @@
-const fs = require("fs/promises");
-const FormData = require("form-data");
-const path = require("path");
-const sharp = require("sharp");
-const Handlebars = require("handlebars");
-const readline = require("readline");
-const https = require("https");
-require("dotenv").config();
-
-// New version image hbs directory
-const templateDir = path.join(__dirname, "new-version.hbs");
-
-// Version to be Released
-// Remember you should run this script using 'npm ...' command to have npm environment variables
-const version = process.env.npm_package_version;
-
-// Telegram Bot Info (Bot Token Should Be Manually Provided Using dotenv)
-const token = process.env.TELEGRAM_BOT_TOKEN;
-const chatId = "-651191778";
-
-const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout,
-});
-
-const releaseNotes = [];
-
-rl.setPrompt("Release Notes:\n");
-
-rl.prompt();
-
-rl.on("line", function (ln) {
-  releaseNotes.push(ln);
-});
-
-// Press Ctrl+C to Just Exit
-rl.on("SIGINT", () => process.exit(0));
-
-// Press Ctrl+D to Emit 'close' Event and Send Release Notes
-rl.on("close", sendReleaseNotes);
-
-// Returns Buffer of New Version Image
-async function createReleaseImage() {
-  return fs
-    .readFile(templateDir)
-    .then((templateBuffer) => {
-      const template = Handlebars.compile(templateBuffer.toString(), "utf-8");
-      let ctx = {
-        version,
-      };
-      const xml = template(ctx);
-
-      const buf = Buffer.from(xml, "utf8");
-      return sharp(buf).resize({ width: 350 }).jpeg({ quality: 100 }).toBuffer();
-    })
-    .catch((err) => {
-      throw err;
-    });
-}
-
-async function sendReleaseNotes() {
-  // Text to be Sent
-  const caption = `Version *${version}* Released!\n\n_Release Notes:_\n${releaseNotes.join("\n")}`;
-  const photoBuf = await createReleaseImage();
-
-  let form = new FormData();
-
-  form.append("chat_id", chatId);
-  form.append("photo", photoBuf, { filename: "image.jpeg" });
-  form.append("caption", caption);
-  form.append("parse_mode", "Markdown");
-
-  // HTTP Request Options (URL & Headers & Method)
-  const options = {
-    hostname: "api.telegram.org",
-    path: `/bot${token}/sendPhoto`,
-    protocol: "https:",
-  };
-
-  form.submit(options, (err, res) => {
-    console.log(`statusCode: ${res.statusCode}`);
-
-    res.on("data", (d) => {
-      process.stdout.write(d);
-    });
-
-    if (err) console.log(err);
-
-    res.emit("end");
-  });
-}

package/src/publish/new-version.hbs

@@ -1,11 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<svg version="1.1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 500 400" font-family="Dana">
-  <rect x="0" y="0" width="500" height="400" fill="#EA6B13"/>
-  <g transform="translate(250, 200)">
-    <text x="0" y="-75" fill="white" fill-opacity="0.25" font-size="36" font-weight="800" text-anchor="middle">RISLOO EXTRACTOR CLI</text>
-    <g transform="translate(0, 65)">
-      <text x="0" y="0" fill="black" fill-opacity="0.25" font-size="88" font-weight="900" text-anchor="middle">v {{version}}</text>
-      <text x="0" y="0" fill="white" font-size="96" font-weight="900" text-anchor="middle">v {{version}}</text>
-    </g>
-  </g>
-</svg>