npm - @rubytech/create-maxy-code - Versions diffs - 0.1.97 → 0.1.99 - Mend

@rubytech/create-maxy-code 0.1.97 → 0.1.99

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

package/payload/premium-plugins/founder-pack/skills/investor-data-room/references/html-pdf-pipeline.md ADDED Viewed

@@ -0,0 +1,236 @@
+# HTML + PDF render pipeline
+Image-only A4 portrait PDF, rendered from a single HTML file via Playwright + img2pdf + qpdf. Mirrors the constraints in the `property-brochure:a4-print-documents` skill.
+## File layout per artefact
+```
+html/<artefact>/
+  index.html        # source of truth
+  render-pdf.mjs    # Playwright pipeline
+  <artefact>.pdf    # rendered output
+  logo-light.png    # for dark cover/backpage
+  logo-dark.png     # for light content pages (optional)
+  README.md         # render + verify commands, page list
+```
+## HTML scaffold (key blocks)
+```html
+<!DOCTYPE html>
+<html lang="en-GB">
+<head>
+  <meta charset="UTF-8">
+  <link href="https://fonts.googleapis.com/css2?family=Cormorant+Garamond:ital,wght@0,400;0,500;0,600;0,700;1,400&family=Inter:wght@400;500;600;700&family=Lora:ital,wght@0,400;0,500;0,600;1,400&display=swap" rel="stylesheet">
+  <style>
+    /* Tier 1 + Tier 2 design tokens from project's design-tokens.md */
+    :root {
+      --teal-900: #0E1418;
+      --teal-950: #06080A;
+      --gold-500: #A4884C;
+      --gold-300: #C9B07A;
+      --gold-700: #7A6235;
+      --paper-0:  #FFFFFF;
+      --paper-25: #FBFAF6;
+      --paper-100: #ECF1F2;
+      --slate-400: #8A8E96;
+      --slate-600: #5C6470;
+      --rule-fine: #E2D5BD;
+      --serif: 'Cormorant Garamond', serif;
+      --body-serif: 'Lora', Georgia, serif;
+      --sans: 'Inter', sans-serif;
+      --surface-page: var(--paper-25);
+      --surface-deep: var(--teal-950);
+      --text-primary: var(--teal-900);
+      --text-on-deep: var(--paper-25);
+      --text-accent: var(--gold-700);
+      --text-accent-on-deep: var(--gold-300);
+    }
+    @page { size: A4 portrait; margin: 18mm 16mm 20mm; }
+    @page :first { margin: 0; }
+    @page backpage-full { margin: 0; }
+    body {
+      margin: 0;
+      background: var(--surface-page);
+      color: var(--text-primary);
+      font-family: var(--body-serif);
+      font-size: 11pt;
+      line-height: 1.55;
+      counter-reset: pagenum;
+    }
+    .page {
+      counter-increment: pagenum;
+      position: relative;
+    }
+    .page:not(.page--cover):not(.page--backpage)::after {
+      content: counter(pagenum);
+      position: absolute;
+      bottom: 10mm;
+      right: 16mm;
+      font-family: var(--sans);
+      font-size: 9pt;
+      letter-spacing: 0.28em;
+      color: var(--slate-400);
+    }
+    .page:not(.page--cover):not(.page--backpage)::before {
+      content: "REAL AGENT NETWORK LIMITED · BUSINESS PLAN · v1.0";
+      position: absolute;
+      bottom: 10mm;
+      left: 16mm;
+      font-family: var(--sans);
+      font-size: 7pt;
+      letter-spacing: 0.24em;
+      color: var(--slate-400);
+    }
+    @media screen {
+      body { background: #FFFFFF; padding: 24px; }
+      .page {
+        width: 210mm; min-height: 297mm;
+        margin: 20px auto; padding: 18mm 16mm 20mm;
+        background: var(--surface-page);
+        box-shadow: 0 4px 28px rgba(0,0,0,0.14);
+      }
+      .page--cover, .page--backpage { padding: 0; overflow: hidden; }
+    }
+    @media print {
+      body { background: var(--surface-page); padding: 0; }
+      .page { page-break-after: always; padding: 0; }
+      .page--cover, .page--backpage {
+        margin: 0; width: auto; box-shadow: none;
+        height: 100vh; position: relative; overflow: hidden;
+        -webkit-print-color-adjust: exact;
+        print-color-adjust: exact;
+      }
+      .page--backpage { page-break-before: always; page: backpage-full; }
+      .download-btn { display: none !important; }
+    }
+    .download-btn {
+      position: fixed; top: 20px; right: 20px; z-index: 100;
+      font-family: var(--sans); font-size: 9pt; letter-spacing: 0.28em;
+      text-transform: uppercase; color: var(--paper-0);
+      background: var(--teal-900); padding: 11px 18px 12px;
+      border-radius: 9999px; text-decoration: none;
+      box-shadow: 0 4px 16px rgba(14, 20, 24, 0.18);
+    }
+    .download-btn:hover { background: var(--gold-700); }
+  </style>
+</head>
+<body>
+  <a class="download-btn" href="<artefact>.pdf" download>Download PDF</a>
+  <section class="page page--cover" data-screen-label="cover"> ... </section>
+  <section class="page" data-screen-label="exec-summary"> ... </section>
+  <!-- ... one <section class="page"> per A4 page ... -->
+  <section class="page page--backpage" data-screen-label="backpage"> ... </section>
+</body>
+</html>
+```
+## render-pdf.mjs (canonical)
+```javascript
+#!/usr/bin/env node
+import { chromium } from 'playwright';
+import { execFileSync } from 'node:child_process';
+import { mkdirSync, rmSync, existsSync } from 'node:fs';
+import { dirname, basename, join, resolve, extname } from 'node:path';
+import { pathToFileURL } from 'node:url';
+const [, , htmlInput, pdfOutput] = process.argv;
+if (!htmlInput || !pdfOutput) {
+  console.error('Usage: render-pdf.mjs <input.html> <output.pdf>');
+  process.exit(64);
+}
+const htmlPath = resolve(htmlInput);
+const pdfPath  = resolve(pdfOutput);
+const tmpDir = resolve(dirname(pdfPath), `.tmp-${basename(pdfPath, extname(pdfPath))}`);
+rmSync(tmpDir, { recursive: true, force: true });
+mkdirSync(tmpDir, { recursive: true });
+const VIEWPORT_W = 794;        // A4 portrait at 96 dpi
+const VIEWPORT_H = 1123;
+const SCALE = 3.125;           // → 300 dpi PNGs
+const A4_HEIGHT_PX_SLACK = VIEWPORT_H + 2;
+(async () => {
+  const browser = await chromium.launch();
+  const context = await browser.newContext({
+    viewport: { width: VIEWPORT_W, height: VIEWPORT_H },
+    deviceScaleFactor: SCALE,
+  });
+  const page = await context.newPage();
+  await page.goto(pathToFileURL(htmlPath).toString(), { waitUntil: 'networkidle' });
+  await page.emulateMedia({ media: 'print' });
+  await page.evaluate(() => document.fonts ? document.fonts.ready : Promise.resolve());
+  await page.evaluate(() => { document.body.style.padding = '0'; });
+  const sections = await page.$$('section.page');
+  if (sections.length === 0) {
+    console.error('No <section class="page"> elements found.');
+    process.exit(65);
+  }
+  const pngFiles = [];
+  let overflow = false;
+  for (let i = 0; i < sections.length; i++) {
+    const section = sections[i];
+    const label = await section.getAttribute('data-screen-label') || `page${i + 1}`;
+    const scrollHeight = await section.evaluate(el => el.scrollHeight);
+    if (scrollHeight > A4_HEIGHT_PX_SLACK) {
+      console.error(`[OVERFLOW] page ${i + 1} (${label}): ${scrollHeight}px > A4 + 2px slack`);
+      overflow = true;
+    }
+    const outPath = join(tmpDir, `page-${String(i + 1).padStart(2, '0')}-${label}.png`);
+    await section.scrollIntoViewIfNeeded();
+    await section.screenshot({ path: outPath, type: 'png' });
+    pngFiles.push(outPath);
+  }
+  await browser.close();
+  if (overflow) {
+    console.error('Overflow detected. Aborting.');
+    process.exit(4);
+  }
+  const preLinearize = join(tmpDir, 'pre-linearize.pdf');
+  execFileSync('img2pdf', ['--pagesize', '210mmx297mm', '--output', preLinearize, ...pngFiles], { stdio: 'inherit' });
+  execFileSync('qpdf', ['--linearize', '--object-streams=disable', preLinearize, pdfPath], { stdio: 'inherit' });
+  console.log(`✓ PDF written: ${pdfPath}`);
+})();
+```
+## Verification
+After every render:
+```sh
+qpdf --check <artefact>.pdf                           # → "No syntax or stream encoding errors found"
+pdfinfo  <artefact>.pdf | grep -E "Pages|Optimized"   # → confirms page count + linearization
+```
+Then **read every page visually**. `pdfinfo` reporting "25 pages, A4" is not verification.
+## Dependencies
+```sh
+npm i -D playwright && npx playwright install chromium
+brew install img2pdf qpdf
+```
+## Hard rules
+- One `<section class="page">` per A4 page. Renderer aborts (exit 4) on overflow.
+- `execFileSync` (never `execSync` with template strings).
+- Cover and backpage are full-bleed dark teal (`--surface-deep`); skip page numbers and running footer via `:not(.page--cover):not(.page--backpage)` selectors on the page-counter pseudo-elements.
+- Even page count for booklet binding (multiple of 4 ideal).
+- Logo: copy the white-mono icon variant as `logo-light.png` for dark cover/backpage; copy the dark icon variant as `logo-dark.png` if used on light content pages.

package/payload/premium-plugins/founder-pack/skills/investor-data-room/references/internal-workings-scrub.md ADDED Viewed

@@ -0,0 +1,33 @@
+# Internal-workings scrub — public-vs-internal doctrine
+Public-facing documents (business plan, prospectus, deck, term sheet, anything the investor reads) state the **current position** only. The journey to that position, the reasoning behind it, comparisons against prior baselines, open items still being reconciled, and cross-references to internal sections all stay in working documents in the data-room's internal sections.
+## Patterns that must NOT appear in public docs
+- **Comparison to baseline / prior version.** *"The loss has grown from -£282.6k to -£323.1k because…"*, *"Total opex (M0 customer-success hire adds £40,500 vs the M10 model worksheet baseline)"*.
+- **Process commentary.** *"Numbers below use the model's published figures pending the reconciled rebuild"*, *"reconciliation pending"*, *"open item, not actioned here"*, *"see Section X critical note and Section Y contingency levers for the reconciliation paths"*.
+- **Internal cross-references to scaffolding.** *"see Section 12.3 critical note"*, *"see Section 12.6 contingency levers"* when the linked content itself is process-talk rather than substance.
+- **Discrepancy resolution narratives.** *"The earlier '£0.01 vs £0.001 nominal' note is resolved by treating the £4,500 as share premium"*.
+- **"Open Q" or "Open item" markers in body text.** Belongs in section READMEs and the office-hours design doc only.
+- **Date-coded internal designs.** *"2026-04-22 design"*, *"office-hours design doc"*, *"model worksheet (Appendix A) needs a rebuild"*.
+- **"Pre-contingency-lever activation" / "once X is included" hedges in summary tables.**
+- **Explanatory parentheticals that name the process.** *"(M10-trigger model did not carry)"* is process commentary and must go.
+## What IS acceptable in a public-facing document
+- The current position, stated as a fact.
+- A footnote citing a source (Companies House, IBISWorld, ICO, etc.) when the figure derives from public data.
+- A pointer to a public appendix (titled documents only; not internal-section READMEs).
+- Conditions on a forecast figure that an investor needs to know (e.g. "assuming Round 2 closes at M9-M10").
+## The same content, internal vs public
+| Internal version (working doc) | Public version (business plan) |
+|---|---|
+| Total operating expenses ~£649,100 (M0 customer-success hire adds £40,500 vs the M10 model worksheet baseline). | Total operating expenses ~£649,100. |
+| Year-1 P&L loss has grown from -£282.6k to -£323.1k because the customer-success hire is brought forward from M10 to M0. | Year-1 P&L loss is approximately £323k against revenue of £356k. |
+| Cash crosses zero at M8–M9 if Round 2 does not close; the model worksheet's M11 £34k cash low arrives roughly two months earlier under the M0 CS hire structure. | The raise is sized to deliver the Round 2 gating milestones; Round 2 closes at M9 to M10. |
+## Recurrence is a P0 violation
+In the reference project this rule was violated three times in one session (initial draft used a dated internal design reference; appendix table referenced internal-only documents alongside externally-shareable ones; M0 customer-success hire updates added "model worksheet baseline" comparisons). The pattern: every time the founder adds content or asks for an update, the temptation is to include "what changed and why" alongside the new value. The temptation must be resisted; the public document carries only the new value. The "what changed and why" goes in a sibling internal document if it needs to live somewhere.

package/payload/premium-plugins/founder-pack/skills/investor-data-room/references/termsheet-template.md ADDED Viewed

@@ -0,0 +1,66 @@
+# Term sheet template
+A4-portrait, 6-to-8-page formal term sheet, same render pipeline as the business plan (Playwright + img2pdf + qpdf). Lives at `html/prospectus/term_sheet.html`. The reference project produces a 7-page artefact: cover + 5 content pages + signatures.
+## Page-by-page structure
+| # | Page | Contents |
+|---|---|---|
+| 1 | Cover + preamble | Issuer (full Companies-House-filed legal name), document title, "Non-binding — confidentiality and exclusivity bind", preamble (round purpose, recipient self-cert reminder), introductory parties table (Issuer, Founders list, Investors, round size, minimum cheque, minimum aggregate, target first close) |
+| 2 | Share economics &amp; use of proceeds | Instrument (ordinary £0.001 or £0.01 nominal, ranking *pari passu*), pre-money / post-money / dilution, issue price (computed from pre-money ÷ pre-investment shares), Round Share count, use of proceeds split, long-stop date, funds-expected timing |
+| 3 | Cap table on closing | Holder / Role / Shares / % table; founders subtotal; Round Shares row; total = 100% / 625,000 |
+| 4 | Governance &amp; shareholder protections | Board composition (director-designate per IN01), information rights (≥5% threshold), pre-emption, drag-along / tag-along, share-transfer good-leaver / bad-leaver, SEIS/EIS posture, confidentiality (binding), exclusivity (binding) |
+| 5 | Closing terms | Governing law (English), expenses (each party bears own), founder IP assignment (deed at first close, no licence-back, no royalty), conditions to closing, long-form documentation timeline |
+| 6 | Signatures | Company block (director-designate per IN01) + Investor block (name / entity / commitment / signature line) |
+| 7 | Investor self-certification (optional) | UK self-cert criteria check-list with signature block |
+| 8 | Backpage | Contact card + confidentiality reminder + companies-house identifier |
+## Cap table reconciliation
+The cap table on closing **must reconcile against the IN01 + the Round 1 dilution model exactly**. The pattern from the reference project:
+| Step | Source |
+|---|---|
+| Pre-investment shares (e.g. 500,000) | IN01 statement of capital |
+| Per-founder pre-investment % | IN01 cap table |
+| Dilution % | (Round size / post-money) = 350 / 1,750 = 20% in the reference project |
+| Post-investment % per founder | Pre-investment % × (1 − dilution%) |
+| Post-investment shares per founder | Pre-investment shares × (1 − dilution%) — note this only works if all founders dilute pro rata |
+| Round Shares | New investor's post-investment % × total post-investment shares |
+| Total post-closing shares | Pre-investment shares ÷ (1 − dilution%) |
+Reference project numbers (pre 500k, dilution 20%):
+- Joel 24.90% / 124,500 → 19.92% / 124,500 (no change in shares; dilution is via issuance of new shares)
+- Adam 24.90% / 124,500 → 19.92% / 124,500
+- Alex 20.00% / 100,000 → 16.00% / 100,000
+- Jamie 15.16% / 75,813 → 12.13% / 75,813
+- BackleyBlack 8.75% / 43,749 → 7.00% / 43,749
+- Stewart Smalley 6.29% / 31,438 → 5.03% / 31,438
+- Founders subtotal 500,000 / 80.00%
+- New investors (Round 1) 125,000 / 20.00%
+- Total post-closing 625,000 / 100.00%
+Issue price = pre-money / pre-investment shares = £1,400,000 / 500,000 = **£2.80 per Round Share** (£0.001 nominal + £2.799 share premium in the reference project where nominal was £0.001; or £0.01 nominal + £2.79 premium if the term sheet sets nominal at £0.01).
+## Doctrine
+- **Issuer name is the IN01-filed legal entity.** Stale term sheets that reference a marketing entity (e.g. "Real Agent Systems Ltd" instead of the filed "Real Agent Network Limited") are defects. The Companies House number on every page header should match.
+- **Founder list reads exactly as the cap table.** Six holders on the cap table = six in the founder list. No phantom founders. Strategic shareholders (e.g. an investing LLP) ride in by entity name, not by their constituent individuals.
+- **Sole director on IN01 is the director-designate on the term sheet's signature page.** A term sheet that names two directors when IN01 named one needs reconciling before issue.
+- **SEIS/EIS posture is post-funding obligation, never closing contingency.** Never assured prior to distribution; no representation as to qualifying status. Forms no part of consideration.
+- **Confidentiality + exclusivity bind; everything else is non-binding** until subscription &amp; shareholders' agreement.
+## Render
+Same `render-pdf.mjs` pattern as the business plan; viewport 794×1123 (A4 portrait at 96 dpi), deviceScaleFactor 3.125 (300 dpi PNG), `img2pdf --pagesize 210mmx297mm`, `qpdf --linearize`. Output: `html/prospectus/term_sheet.pdf`.
+## Common defects to avoid
+| Defect | Fix |
+|---|---|
+| Issuer name mismatch (marketing vs filed) | Use the IN01 legal name verbatim on every page header |
+| Founder list includes individuals also represented by an LLP holding | Use the LLP holding only; do not double-count |
+| Issue price stated without showing the calculation | `£2.80 = £1.4m ÷ 500,000 pre-shares` in the issue-price row |
+| Cap-table % rounding doesn't sum to 100% | Compute % as `shares / total` and verify the sum; never hand-enter % rows |
+| SEIS/EIS implied as confirmed | "Pursuing SEIS/EIS Advance Assurance from HMRC is a post-funding obligation … not a closing contingency … no representation as to qualifying status" |
+| Director-designate doesn't match IN01 | Read the IN01 PDF; the proposed director on IN01 is the director-designate |