@pikaa-ai/pikaa 0.3.1 → 0.3.4

package/skills/pptx-posters/assets/poster_manifest_template.json

@@ -1,154 +0,0 @@
-{
-  "schema_version": "2.0",
-  "document": {
-    "id": "REPLACE_ME_DOCUMENT_ID",
-    "title": "REPLACE_ME_TITLE",
-    "subject": "REPLACE_ME_SUBJECT",
-    "language": "REPLACE_ME_BCP47_LANGUAGE",
-    "authors": [
-      "REPLACE_ME_AUTHOR"
-    ],
-    "source_ids": [
-      "REPLACE_ME_CONTENT_SOURCE_ID"
-    ]
-  },
-  "canvas": {
-    "width_in": "REPLACE_ME_POWERPOINT_WIDTH",
-    "height_in": "REPLACE_ME_POWERPOINT_HEIGHT",
-    "background_color": "#FFFFFF"
-  },
-  "physical_output": {
-    "trim_width_in": "REPLACE_ME_TRIM_WIDTH",
-    "trim_height_in": "REPLACE_ME_TRIM_HEIGHT",
-    "bleed_in": "REPLACE_ME_BLEED",
-    "safe_margin_in": "REPLACE_ME_SAFE_MARGIN",
-    "orientation": "REPLACE_ME_ORIENTATION"
-  },
-  "requirements": {
-    "conference": {
-      "confirmed": false,
-      "source_id": "REPLACE_ME_CONFERENCE_SOURCE_ID",
-      "max_width_in": "REPLACE_ME_CONFERENCE_MAX_WIDTH",
-      "max_height_in": "REPLACE_ME_CONFERENCE_MAX_HEIGHT",
-      "orientation": "REPLACE_ME_CONFERENCE_ORIENTATION",
-      "required_delivery_format": "REPLACE_ME_DELIVERY_FORMAT",
-      "notes": "REPLACE_ME_CONFERENCE_NOTES"
-    },
-    "printer": {
-      "confirmed": false,
-      "source_id": "REPLACE_ME_PRINTER_SOURCE_ID",
-      "trim_width_in": "REPLACE_ME_PRINTER_TRIM_WIDTH",
-      "trim_height_in": "REPLACE_ME_PRINTER_TRIM_HEIGHT",
-      "bleed_in": "REPLACE_ME_PRINTER_BLEED",
-      "safe_margin_in": "REPLACE_ME_PRINTER_SAFE_MARGIN",
-      "accepted_color_mode": "REPLACE_ME_COLOR_MODE",
-      "scaling_allowed": false,
-      "notes": "REPLACE_ME_PRINTER_NOTES"
-    }
-  },
-  "quality": {
-    "minimum_font_pt_final": "REPLACE_ME_FINAL_FONT_THRESHOLD",
-    "font_guidance_basis": "heuristic",
-    "font_guidance_source_id": null,
-    "minimum_raster_dpi_final": "REPLACE_ME_FINAL_DPI_THRESHOLD",
-    "raster_dpi_basis": "heuristic",
-    "raster_dpi_source_id": null
-  },
-  "palette": {
-    "colors": {
-      "black": "#000000",
-      "white": "#FFFFFF"
-    },
-    "contrast_pairs": [
-      {
-        "id": "black_on_white",
-        "foreground_color_id": "black",
-        "background_color_id": "white",
-        "usage": "normal_text"
-      }
-    ],
-    "data_series_redundant_encoding": false
-  },
-  "sources": [
-    {
-      "id": "REPLACE_ME_CONFERENCE_SOURCE_ID",
-      "kind": "conference_rule",
-      "citation": "REPLACE_ME_CONFERENCE_CITATION",
-      "locator": "REPLACE_ME_CONFERENCE_LOCATOR",
-      "author_verified": false
-    },
-    {
-      "id": "REPLACE_ME_PRINTER_SOURCE_ID",
-      "kind": "printer_rule",
-      "citation": "REPLACE_ME_PRINTER_CITATION",
-      "locator": "REPLACE_ME_PRINTER_LOCATOR",
-      "author_verified": false
-    },
-    {
-      "id": "REPLACE_ME_CONTENT_SOURCE_ID",
-      "kind": "author_content",
-      "citation": "REPLACE_ME_CONTENT_CITATION",
-      "locator": "REPLACE_ME_CONTENT_LOCATOR",
-      "author_verified": false
-    }
-  ],
-  "assets": [],
-  "elements": [
-    {
-      "id": "title",
-      "type": "text",
-      "reading_order": 1,
-      "x_in": "REPLACE_ME_X",
-      "y_in": "REPLACE_ME_Y",
-      "width_in": "REPLACE_ME_WIDTH",
-      "height_in": "REPLACE_ME_HEIGHT",
-      "source_ids": [
-        "REPLACE_ME_CONTENT_SOURCE_ID"
-      ],
-      "author_approved": false,
-      "allow_in_bleed": false,
-      "role": "title",
-      "text": "REPLACE_ME_TITLE",
-      "font_size_pt_design": "REPLACE_ME_DESIGN_FONT_SIZE",
-      "font_face": "REPLACE_ME_FONT",
-      "bold": true,
-      "align": "left",
-      "vertical_align": "middle",
-      "contrast_pair_id": "black_on_white",
-      "line_color_id": null,
-      "line_width_pt": 0,
-      "margin_in": "REPLACE_ME_MARGIN"
-    },
-    {
-      "id": "body",
-      "type": "text",
-      "reading_order": 2,
-      "x_in": "REPLACE_ME_X",
-      "y_in": "REPLACE_ME_Y",
-      "width_in": "REPLACE_ME_WIDTH",
-      "height_in": "REPLACE_ME_HEIGHT",
-      "source_ids": [
-        "REPLACE_ME_CONTENT_SOURCE_ID"
-      ],
-      "author_approved": false,
-      "allow_in_bleed": false,
-      "role": "body",
-      "text": "REPLACE_ME_AUTHOR_APPROVED_BODY_TEXT",
-      "font_size_pt_design": "REPLACE_ME_DESIGN_FONT_SIZE",
-      "font_face": "REPLACE_ME_FONT",
-      "bold": false,
-      "align": "left",
-      "vertical_align": "top",
-      "contrast_pair_id": "black_on_white",
-      "line_color_id": null,
-      "line_width_pt": 0,
-      "margin_in": "REPLACE_ME_MARGIN"
-    }
-  ],
-  "approval": {
-    "status": "draft",
-    "approved_by": null,
-    "approved_at": null,
-    "content_sha256": null
-  }
-}

package/skills/pptx-posters/assets/poster_quality_checklist.md

@@ -1,192 +0,0 @@
-# PPTX poster release checklist
-
-Use this checklist for the final generated package and every exported/printed
-derivative. A script pass is necessary but not sufficient.
-
-## 1. Requirements and approval
-
-- [ ] The organizer's current poster rule is recorded with an exact source ID.
-- [ ] The printer's current trim, bleed, safe-margin, scaling, file-format, and
-      color requirements are recorded with an exact source ID.
-- [ ] The selected physical trim size and orientation comply with those records.
-- [ ] No generic "standard poster size" was substituted for organizer/printer rules.
-- [ ] Every claim, number, citation, author name, affiliation, logo, figure, and
-      asset license has an exact source ID.
-- [ ] Every source record is marked author-verified.
-- [ ] Every element and asset is marked author-approved.
-- [ ] No placeholder, sample claim, invented citation, or inferred result remains.
-- [ ] The approving author reviewed the canonical content hash after the final edit.
-
-Run:
-
-```bash
-python -B scripts/validate_manifest.py poster.json
-```
-
-## 2. Safe local generation
-
-- [ ] Generation used the exact versions in `generation_dependencies.json`.
-- [ ] All optional image paths are manifest-relative local PNG/JPEG files.
-- [ ] Every asset hash matches.
-- [ ] Every asset has exact provenance and a license/permission statement.
-- [ ] No template file, remote image, URL download, API key, environment file,
-      image-generation service, or network service was used.
-- [ ] The output path was new; no existing file was replaced.
-- [ ] The generated file is `.pptx`, never `.pptm`.
-
-Run:
-
-```bash
-uv run --with "python-pptx==1.0.2" --with "Pillow==12.3.0" \
-  --with "lxml==6.1.1" \
-  python -B scripts/generate_poster.py poster.json --output poster.pptx
-```
-
-## 3. PPTX package security
-
-- [ ] ZIP member names have no traversal, absolute paths, symlinks, duplicates,
-      encryption, oversized entries, or excessive expansion ratios.
-- [ ] The package has the standard macro-free PresentationML content type.
-- [ ] The package matches the strict generated one-slide part profile.
-- [ ] No VBA, ActiveX, OLE, embedded package, executable/binary payload, external
-      link part, or custom UI is present.
-- [ ] No relationship has `TargetMode="External"`.
-- [ ] No remotely linked image is present.
-- [ ] Internal relationship targets resolve to existing package parts.
-- [ ] The presentation was inspected as ZIP/XML and was not opened or executed by
-      the inspection script.
-
-Run:
-
-```bash
-python -B scripts/inspect_pptx.py poster.pptx
-```
-
-Treat any package finding as a release blocker. Do not "fix" an untrusted package
-by opening it in PowerPoint.
-
-## 4. Dimensions, scale, bleed, and margins
-
-- [ ] PowerPoint canvas width and height are each in the current 1–56 inch range.
-- [ ] Final physical trim dimensions are recorded separately from canvas dimensions.
-- [ ] Final artboard dimensions include twice the confirmed bleed on each axis.
-- [ ] Canvas and final artboard have the same aspect ratio.
-- [ ] Uniform print scale is explicit; no nonuniform stretching is allowed.
-- [ ] Printer permission is recorded if final output is scaled from the PPTX canvas.
-- [ ] All non-bleed content stays inside the confirmed safe margin from the trim edge.
-- [ ] Full-bleed imagery reaches the artboard edge and does not move text into bleed.
-- [ ] A physical or contract proof confirms trim and bleed behavior.
-
-Run:
-
-```bash
-python -B scripts/plan_export.py poster.json
-```
-
-## 5. Layout and typography
-
-- [ ] No shape is out of bounds.
-- [ ] Every reported bounding-box overlap is either removed or documented as
-      intentional after visual inspection.
-- [ ] No text box visibly overflows, clips, wraps unexpectedly, or uses silent
-      auto-shrink.
-- [ ] Font sizes were assessed at final physical output, not only on the PPTX canvas.
-- [ ] The manifest labels its minimum-font value as a project heuristic or ties it
-      to an exact organizer/printer/source requirement.
-- [ ] Required fonts are available on the export workstation and printer workflow.
-- [ ] Font embedding rights and the chosen embed/not-embed workflow were reviewed;
-      the generator itself did not embed fonts.
-- [ ] Font substitution, equations, symbols, and scientific glyphs were checked.
-- [ ] Visual hierarchy and reading path remain clear at reduced-scale proof size.
-
-Run:
-
-```bash
-python -B scripts/check_layout.py poster.pptx --manifest poster.json
-```
-
-The checker cannot determine rendered overflow or font substitution; inspect those
-in PowerPoint and in the exported PDF.
-
-## 6. Raster images and assets
-
-- [ ] Effective DPI is calculated from pixel dimensions divided by final placed
-      inches, not from file metadata.
-- [ ] Every placement meets the manifest's source-labeled or heuristic DPI threshold.
-- [ ] No image is stretched out of aspect ratio.
-- [ ] The final PDF and printer proof show no resampling artifacts.
-- [ ] Asset IDs, hashes, source IDs, provenance, permissions/licenses, and alt text are
-      in the inventory.
-- [ ] EXIF, XMP, comments, and embedded text/application metadata were stripped in
-      an author-reviewed offline workflow before hashing and approval.
-- [ ] Logos and images are authorized for this use.
-
-Run:
-
-```bash
-python -B scripts/inventory_images.py poster.json \
-  --output poster.assets.json
-```
-
-## 7. Color and graphical accessibility
-
-- [ ] Normal text pairs meet WCAG 2.2 SC 1.4.3 at 4.5:1.
-- [ ] Large text pairs meet 3:1 only when final text is at least 18 pt, or at least
-      14 pt and bold.
-- [ ] Essential graphical objects meet the 3:1 non-text contrast screen where
-      WCAG 2.2 SC 1.4.11 is being used as the design target.
-- [ ] Information is never encoded by color alone.
-- [ ] Categories also use direct labels, shapes, markers, patterns, or line styles.
-- [ ] Palette selection is appropriate to data type: qualitative, sequential, or
-      diverging.
-- [ ] A grayscale/color-vision simulation is reviewed as a screen, not treated as
-      proof of accessibility.
-- [ ] A color proof confirms the printer's conversion and substrate behavior.
-
-Run:
-
-```bash
-python -B scripts/check_palette.py poster.json
-```
-
-## 8. PowerPoint accessibility
-
-- [ ] Every picture has concise, accurate alt text that conveys purpose.
-- [ ] Complex figures have an approved source-bound native long description when alt
-      text and adjacent prose are insufficient.
-- [ ] Important text is native text, not only pixels inside an image.
-- [ ] The visible title is the native slide-title placeholder and text language is
-      correct.
-- [ ] The Reading Order pane matches the intended logical sequence.
-- [ ] The PowerPoint Accessibility Checker has no unresolved errors.
-- [ ] A keyboard and screen-reader pass confirms the actual reading order.
-- [ ] Text links have meaningful visible labels.
-- [ ] Every QR code has the exact destination URL in visible fallback text.
-- [ ] Each final printed QR code was tested with multiple devices.
-- [ ] Language, author names, acronyms, captions, and table alternatives are correct.
-
-Automated XML inspection cannot certify these manual checks.
-
-## 9. Export and print
-
-- [ ] Export uses PowerPoint's Standard/high print quality, not Minimum size.
-- [ ] No audio, video, linked media, OLE, ActiveX, embedded file, or external
-      relationship was introduced after generation.
-- [ ] Exported PDF page size equals the final artboard expected by the printer.
-- [ ] Exported PDF is checked independently for tags, reading order, alt text,
-      links, fonts, clipping, image quality, and page dimensions.
-- [ ] RGB is distinguished from any printer-required CMYK conversion.
-- [ ] If CMYK is required, the printer-approved conversion/profile and proof are
-      complete; the native PowerPoint export is not represented as CMYK-compliant.
-- [ ] Conference file format, naming, file-size, and submission rules are met.
-- [ ] Printer deadline, substrate, mounting, delivery, and backup requirements are met.
-
-## 10. Final sign-off
-
-- [ ] Presenting/corresponding author approved all scientific content and citations.
-- [ ] Accessibility reviewer completed manual checks.
-- [ ] Printer or production contact approved dimensions, bleed, scale, and color.
-- [ ] The exact approved manifest, PPTX hash, asset inventory, audit reports, exported
-      PDF, and proof are retained together.
-- [ ] A final change triggers a new content hash, new author approval, regeneration,
-      re-export, and all checks again.

package/skills/pptx-posters/references/manifest_spec.md

@@ -1,297 +0,0 @@
-# Poster manifest 2.0
-
-## Purpose
-
-The manifest is the only content input to the generator. It binds:
-
-- approved text and images;
-- exact source IDs;
-- local asset hashes and licenses;
-- PowerPoint canvas and physical output geometry;
-- conference and printer rules;
-- accessibility/quality thresholds and their basis;
-- reading order;
-- author approval to a canonical content hash.
-
-Unknown keys, duplicate JSON keys, non-finite numbers, remote asset paths, path escape,
-unapproved fields, unresolved sources, unused records, and common placeholders are
-rejected.
-
-## Template
-
-`assets/poster_manifest_template.json` is intentionally invalid. It contains
-replacement tokens, false confirmations, and draft approval so it cannot produce a
-poster accidentally.
-
-Copy it into a project directory, then replace every field with reviewed values.
-Asset paths are relative to that manifest's directory.
-
-## Top-level object
-
-Manifest version 2.0 requires exactly these keys:
-
-- `schema_version`
-- `document`
-- `canvas`
-- `physical_output`
-- `requirements`
-- `quality`
-- `palette`
-- `sources`
-- `assets`
-- `elements`
-- `approval`
-
-The validator rejects extensions to the schema rather than silently ignoring them.
-
-## `document`
-
-- `id`: stable identifier beginning with a letter.
-- `title`: exact approved title.
-- `subject`: exact approved description for core document metadata.
-- `language`: BCP 47-style language tag.
-- `authors`: exact ordered author names.
-- `source_ids`: exact records supporting title, subject, language, and author metadata.
-
-Exactly one text element with role `title` must match `document.title` verbatim.
-It must have `reading_order: 1`; generation uses it as the native PowerPoint slide
-title placeholder rather than as an undifferentiated text box.
-
-## `canvas`
-
-- `width_in`, `height_in`: PowerPoint slide dimensions, each 1–56 inches.
-- `background_color`: opaque six-digit sRGB hex.
-
-These are design dimensions, not automatically the physical trim size.
-
-## `physical_output`
-
-- `trim_width_in`, `trim_height_in`: finished physical dimensions.
-- `bleed_in`: physical bleed on each edge.
-- `safe_margin_in`: inset inside the trim edge for non-bleed content.
-- `orientation`: `portrait`, `landscape`, or `square`, matching trim dimensions.
-
-The physical artboard is trim plus twice the bleed. It must share the canvas aspect
-ratio.
-
-## `requirements`
-
-### `conference`
-
-The organizer record must be confirmed and provide:
-
-- exact `source_id`;
-- maximum width and height;
-- orientation (`portrait`, `landscape`, `square`, or `either`);
-- required delivery format (`PDF`, `PPTX`, `PDF_AND_PPTX`, or `OTHER`);
-- notes copied or summarized from the verified rule.
-
-The physical trim dimensions must fit.
-The referenced source record must have kind `conference_rule`.
-
-### `printer`
-
-The printer record must be confirmed and provide:
-
-- exact `source_id`;
-- trim width/height, bleed, and safe margin matching `physical_output`;
-- accepted color mode (`RGB`, `CMYK`, or `PRINTER_MANAGED`);
-- whether uniform scaling is allowed;
-- notes describing the confirmed workflow.
-
-If scaling is forbidden, canvas and physical artboard must be 1:1. A CMYK requirement
-does not prevent creation of an editable RGB PPTX, but the export plan blocks a claim
-of print readiness pending printer-approved conversion/proof.
-The referenced source record must have kind `printer_rule`.
-
-## `quality`
-
-- `minimum_font_pt_final`
-- `font_guidance_basis`
-- `font_guidance_source_id`
-- `minimum_raster_dpi_final`
-- `raster_dpi_basis`
-- `raster_dpi_source_id`
-
-Basis values are:
-
-- `heuristic`
-- `source_specific`
-- `conference_requirement`
-- `printer_requirement`
-
-A heuristic must have a null source ID. Every other basis requires an exact source
-ID. Values apply at final physical output, after uniform scaling.
-
-## `palette`
-
-`colors` maps stable IDs to opaque `#RRGGBB` sRGB values.
-
-Each `contrast_pairs` record contains:
-
-- `id`
-- `foreground_color_id`
-- `background_color_id`
-- `usage`: `normal_text`, `large_text`, or `non_text`
-
-The validator applies 4.5:1 to normal text and 3:1 to large text/non-text. A text
-element using `large_text` must be at least 18 pt final, or at least 14 pt final and
-bold.
-
-`data_series_redundant_encoding` must be true. This is an author confirmation that
-color is supplemented by labels, shapes, markers, patterns, or line styles. It is not
-an automated certification.
-
-## `sources`
-
-Each source has:
-
-- `id`
-- `kind`
-- `citation`
-- `locator`
-- `author_verified: true`
-
-Kinds include author content, publication, dataset, asset license, conference rule,
-printer rule, institutional rule, and other.
-
-Every source must be used, and every referenced ID must exist. The scripts do not
-resolve URLs, DOIs, or local records.
-
-## `assets`
-
-The array may be empty: figures, logos, and QR codes are optional. Only local
-PNG/JPEG assets are accepted when an asset is present. Each record has:
-
-- `id`
-- manifest-relative `path`
-- `role`: `figure`, `logo`, or `qr_code`
-- lowercase SHA-256
-- exact `source_id`
-- `license`: exact license or permission statement
-- `provenance`: exact author-verified origin or generation record
-- concise `alt_text`
-- `author_approved: true`
-- `qr_target`
-
-`qr_target` is null except for QR assets, where it is an exact `https://` URL. Files
-are bounded, final symlinks are rejected, paths cannot escape the manifest directory,
-and hashes must match.
-
-All asset records must be placed in the poster.
-Use one asset record for repeated placement of the same file; duplicate asset paths
-are rejected.
-
-The image inventory rejects EXIF, XMP, comments, and embedded text/application
-metadata to avoid publishing hidden or location-identifying information. Flatten and
-strip such metadata in an author-reviewed offline workflow, then hash and approve the
-resulting pixels as a new asset. ICC profiles and basic technical image fields are
-reported but not silently removed.
-
-## `elements`
-
-Elements are listed in ascending, contiguous `reading_order` from 1. The list order is
-not silently changed.
-
-Every element has:
-
-- `id`, `type`, and `reading_order`
-- design coordinates `x_in`, `y_in`, `width_in`, `height_in`
-- one or more exact `source_ids`
-- `author_approved: true`
-- `allow_in_bleed`
-
-All boxes must stay on the canvas. Non-bleed elements must remain inside the physical
-safe area mapped to the canvas. Text can never be allowed in bleed.
-
-### Text elements
-
-Text elements also specify:
-
-- `role`
-- exact `text`
-- `font_size_pt_design`
-- `font_face`
-- `bold`
-- horizontal and vertical alignment
-- `contrast_pair_id`
-- optional `line_color_id`
-- `line_width_pt`
-- `margin_in`
-
-Roles include title, authors, affiliation, heading, body, caption, reference,
-acknowledgement, contact, QR fallback, and other.
-
-Font size is checked after physical scaling. Text auto-shrink is disabled during
-generation.
-
-### Image elements
-
-Image elements also specify:
-
-- `asset_id`
-- `fit: "contain"`
-- `fallback_text_element_id`
-- `long_description_element_id`
-
-Contain fitting preserves aspect ratio and centers the image. A QR asset requires a
-square box and a fallback text element whose role is `qr_fallback` and whose text
-contains the exact `qr_target`. Other assets use null fallback IDs.
-
-`long_description_element_id` is null when approved alt text and adjacent native text
-are sufficient. For a complex figure that needs a longer explanation, it references
-an approved native text element with role `body`, `caption`, or `other`. That element
-must follow the image in reading order and include every source ID used by the image.
-QR assets use the required visible fallback text and therefore set this field to null.
-The reference is structural; a human must decide whether the description is complete.
-
-## Approval
-
-Draft form:
-
-```json
-{
-  "status": "draft",
-  "approved_by": null,
-  "approved_at": null,
-  "content_sha256": null
-}
-```
-
-After all non-approval fields validate:
-
-```bash
-python -B scripts/validate_manifest.py poster.json \
-  --print-content-hash
-```
-
-Give the exact manifest and reported hash to the author. Approved form requires:
-
-- `status: "approved"`
-- nonempty `approved_by`
-- ISO 8601 `approved_at` with UTC offset
-- exact lowercase `content_sha256`
-
-The hash covers every top-level field except `approval`, using canonical sorted
-UTF-8 JSON. Any content, source, requirement, palette, coordinate, or asset-metadata
-change invalidates approval.
-
-## Validation modes and exit codes
-
-Normal validation reads and hashes assets and requires approval:
-
-```bash
-python -B scripts/validate_manifest.py poster.json
-```
-
-`--structure-only` skips file reads/hashes but still validates path syntax. Use it for
-planning/audit only, never generation.
-
-`--print-content-hash` permits draft approval but does not permit placeholders,
-unverified sources, unapproved elements, or false requirements.
-
-CLIs use:
-
-- exit 0: pass;
-- exit 1: completed audit found a release-blocking issue;
-- exit 2: invalid input, unsafe input, missing dependency, or command error.