[geniodelmale]

Pull Request Checklist

• I have read and followed the CONTRIBUTING.md guidelines.
• I have read and followed the Guidance for submissions involving paid services.
• My contribution adds a new instruction, prompt, agent, skill, workflow, or canvas extension file in the correct directory.
• The file follows the required naming convention.
• The content is clearly structured and follows the example format.
• I have tested my instructions, prompt, agent, skill, workflow, or canvas extension with GitHub Copilot.
• I have run npm start and verified that README.md is up to date.
• I am targeting the main branch for this pull request.

---

Description

Adds the keyboard-2048 canvas as a standalone plugin, preserving the current source implementation and attributing it to its canonical repository. The plugin includes its preview image, runtime modules, and focused game/server tests. The gist-only preview save and legacy extension metadata are excluded.

---

Type of Contribution

• New instruction file.
• New prompt file.
• New agent file.
• New plugin.
• New skill file.
• New agentic workflow.
• New canvas extension.
• Update to existing instruction, prompt, agent, plugin, skill, workflow, or canvas extension.
• Other (please specify):

---

Additional Notes

Validation passed: npm run plugin:validate, npm start, npm run website:data, and node --test extensions/keyboard-2048/game.test.mjs extensions/keyboard-2048/server.test.mjs (22/22 tests). In-app testing with GitHub Copilot was not available. The source project has no standalone license file; this contribution is licensed under MIT per the repository's submission terms.

---

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

[github-actions]

🚦 Submission status: 👀 Ready for review

Risk tier: merge-risk:high — Privileged execution, automation, or review-policy change
Required to merge: passing submission-gate checks plus 1 approval from reviewers with write access, including a maintainer with admin or maintain permission.

Why this tier

• Spawns processes or evaluates code in extensions/keyboard-2048/game.mjs

Automated checks

Check	Status	Details
Line endings	✅ Passed	Passed · logs
Spelling	✅ Passed	Passed · logs
Generated README consistency	✅ Passed	Passed · logs
Plugin and extension validation	✅ Passed	Passed · logs
Canvas extension validation	✅ Passed	Passed · logs
Plugin structure	✅ Passed	Passed · logs
Risk scan	✅ Passed	Passed · logs
Contributor reputation	✅ Passed	Passed · logs
Duplicate resource scan	✅ Passed	Passed · logs
PR quality signal	⏭️ Skipped	Skipped by its workflow · logs
Canvas/plugin smoke test	✅ Passed	Passed · logs

Review

• Approvals: 0/1
• Assigned reviewer: not assigned yet — comment /request-review to ask for one
• Review target date: not set
• Still needed: 1 more approval(s); an approval from a maintainer with admin or maintain permission
• The core-maintainers pool is not staffed yet; an approver with admin or maintain permission is required instead.

Commands

Command	Who	What it does
/rerun-checks	PR author, maintainers	Re-runs failed or incomplete checks and re-evaluates this gate
/request-review	PR author, maintainers	Asks the review rotation to assign a reviewer (adds needs-reviewer)

_{Updated for 8803736 · gate run · This comment is maintained automatically — see submission gate docs.}

[github-actions]

🔒 PR Risk Scan Results

Scanned 12 changed file(s).

Severity	Count
🔴 High	0
🟠 Medium	0
ℹ️ Info	0

✅ No matching risk patterns were detected in changed files.

Skipped non-text or missing files

• extensions/keyboard-2048/assets/preview.png

This is an automated soft-gate report. Findings indicate review targets and do not block merge by themselves.

[github-actions]

🧩 Canvas smoke test

✅ Passed · 0 error(s), 2 warning(s)

Check	Result
Syntax, imports, file safety	✅
Preview image (≥ 400×160 PNG)	✅
Plugin manifests	✅
Materialize	✅
Install (Copilot CLI)	✅

Plugin keyboard-2048 v1.0.0

Field	Value
Description	Play 2048 in a Copilot canvas with keyboard and touch controls, undo, and session saves.
Author	geniodelmale — https://github.com/geniodelmale
License	MIT
Keywords	2048, copilot-canvas, game, keyboard, puzzle, undo
Extensions	keyboard-2048
Materialize	✅
Install	✅

Changed plugin files

• plugins/keyboard-2048/README.md
• plugins/keyboard-2048/plugin.json

Extension keyboard-2048

Field	Value
Registered by	keyboard-2048
Package	—
Preview	1546×1496, 160.2 KB
Modules	6 (3 reachable from extension.mjs)
Files	9

Permissions and capabilities (static analysis of modules reachable from extension.mjs)

• File system access (node:fs)
• Network sockets / local server (node:http, node:net, ...)

Warnings

• game.test.mjs: import "node:test" is not a Node.js builtin, host-provided package, or declared dependency (module is not reachable from extension.mjs)
• server.test.mjs: import "node:test" is not a Node.js builtin, host-provided package, or declared dependency (module is not reachable from extension.mjs)

Changed extension files

• extensions/keyboard-2048/app.mjs
• extensions/keyboard-2048/assets/preview.png
• extensions/keyboard-2048/extension.mjs
• extensions/keyboard-2048/game.mjs
• extensions/keyboard-2048/game.test.mjs
• extensions/keyboard-2048/index.html
• extensions/keyboard-2048/server.mjs
• extensions/keyboard-2048/server.test.mjs
• extensions/keyboard-2048/style.css

---

Static checks compile modules without executing them. Minimum preview size is configurable with CANVAS_PREVIEW_MIN_WIDTH/CANVAS_PREVIEW_MIN_HEIGHT. Workflow run

[Copilot]

🟡 Changes recommended

Uncaught URL-parsing errors can terminate the extension before authentication, while inaccessible tile labels and insufficient dark-mode text contrast also remain unresolved.

3 open issues

• Handle malformed request URLs before token authentication · New
• Give board tiles a role that supports accessible names · New
• Increase dark-mode muted text contrast · New

What changed in this PR

Adds Keyboard 2048 as a standalone Copilot canvas plugin, with source attribution and registration in the repository’s plugin catalog.

Changes:

• Implements the game, keyboard and touch controls, animations, undo, and session saves.
• Adds canvas actions, an authenticated local server, and focused game/server tests.
• Provides plugin metadata, installation instructions, and catalog entries.

File	Description
plugins/​keyboard-2048/​README.md	Documents installation, source attribution, and license.
plugins/​keyboard-2048/​plugin.json	Defines plugin metadata and extension composition.
extensions/​keyboard-2048/​style.css	Styles the board, themes, controls, and animations.
extensions/​keyboard-2048/​server.test.mjs	Tests persistence, command ordering, and HTTP behavior.
extensions/​keyboard-2048/​server.mjs	Provides saved state, authenticated endpoints, and live updates.
extensions/​keyboard-2048/​index.html	Defines the game interface and restart dialog.
extensions/​keyboard-2048/​game.test.mjs	Tests movement, merging, undo, spawning, and save validation.
extensions/​keyboard-2048/​game.mjs	Implements game rules and state validation.
extensions/​keyboard-2048/​extension.mjs	Registers canvas actions and manages panel lifecycles.
extensions/​keyboard-2048/​app.mjs	Handles rendering, animation, input, and server communication.
docs/​README.plugins.md	Adds the plugin to the documentation catalog.
.github/​plugin/​marketplace.json	Registers the plugin for marketplace discovery.

_{Review effort: Balanced (auto)}

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Note

This error may be related to your runner configuration. You can now configure runners for Copilot code review separately from Copilot cloud agent by creating a copilot-code-review.yml file with your setup steps. Read the docs for details.

[Copilot]

🔵 Needs a closer look

Letter shortcuts can trigger unintended actions while toolbar buttons have focus, and the module bootstrap can run before the board exists, leaving the game stuck loading.

No open issues 🎉

2 previously missed issues

In code that hasn't changed since last review

Restrict letter shortcuts to board focus

extensions/​keyboard-2048/​app.mjs:158

The unmodified WASD, U, and N shortcuts fire even when focus is on a toolbar button rather than the board. This can cause unintended moves, undo, or restart prompts for speech-input users, and there is no way to disable or remap the shortcuts (WCAG 2.1.4). Bind this handler to the focusable board so letter shortcuts are active only while that component has focus.

Wait for board markup before loading the module

extensions/​keyboard-2048/​index.html:25

Dynamically inserted module scripts execute asynchronously; unlike a parser-inserted module, this does not wait for the document to finish parsing. If the module loads while the parser is still processing the body, app.mjs captures a null #board and throws at board.parentElement.append(...), leaving the game stuck on “Loading game...”. Append the module after DOMContentLoaded, or move this bootstrap below the board markup.

2 resolved since last review

• Increase dark-mode muted text contrast
• Give board tiles a role that supports accessible names

_{Review effort: Balanced (auto)}

[Copilot]

🔵 Needs a closer look

Overlapping opens for the same instance can create duplicate servers before the panel is cached, leaving one server and its store subscription running after close.

No open issues 🎉

1 previously missed issue

In code that hasn't changed since last review

Prevent duplicate servers from overlapping opens

extensions/​keyboard-2048/​extension.mjs:60

Two overlapping opens for the same instanceId can both pass the map check because await store() yields before the panel is cached. Each starts a server, but onClose() closes only the one retained in the map, leaving the other server and store subscription running. Cache a promise that includes store initialization before awaiting it so overlapping opens share one server.

_{Review effort: Balanced (auto)}

[Copilot]

🔵 Needs a closer look

In-app Copilot behavior remains unverified because lifecycle tests stub the SDK, leaving installation, canvas rendering, controls, and saved-game restoration for maintainer validation.

No open issues 🎉

_{Review effort: Balanced (auto)}