shipseal 0.0.1

package/LICENSE

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

package/README.md

@@ -0,0 +1,61 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/akii09/shipseal/main/assets/brand/wordmark-800.png" alt="Shipseal" width="400">
+</p>
+
+<p align="center">
+  <strong>Every release, sealed and ready to share.</strong>
+</p>
+
+Shipseal turns your repo's releases, milestones, and benchmarks into ready-to-post visuals: OG images, X and LinkedIn cards, GitHub social previews. On brand, at the right size, with **every number verified** from a real source.
+
+> Status: **pre-alpha**. Not usable yet. Follow progress at [shipseal.dev](https://shipseal.dev).
+
+## Install
+
+```bash
+npx shipseal init       # detect your brand once
+npx shipseal release    # generate the release pack
+```
+
+## How it works
+
+```
+repo facts  ->  optional AI copy (words only)  ->  your brand + templates  ->  Takumi render  ->  image pack + manifest
+```
+
+Facts come from git, the GitHub API, npm, or your CI. An optional LLM writes words and never numbers, so every figure on a card is listed with its source in `manifest.json`. Rendering uses [Takumi](https://takumi.kane.tw): no headless browser, no image model, deterministic output.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `shipseal init` | Detect brand (name, tagline, colors, logo, fonts) and write `.shipseal/` |
+| `shipseal release` | Generate the release pack for a tag |
+| `shipseal milestone` | Card for a crossed stars, downloads, or contributors threshold |
+| `shipseal bench` | Before and after cards from a benchmark JSON file |
+| `shipseal doctor` | Check the environment and report fixes |
+
+## GitHub Action
+
+```yaml
+on: { release: { types: [published] } }
+permissions: { contents: write }
+jobs:
+  visuals:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 }
+      - uses: akii09/shipseal@v1
+        env: { GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}" }
+```
+
+`fetch-depth: 0` is required: release facts need full history and tags.
+
+## Documentation
+
+Full specification in [docs/PROJECT_PLAN.md](https://github.com/akii09/shipseal/blob/main/docs/PROJECT_PLAN.md). Contributions: read [AGENTS.md](https://github.com/akii09/shipseal/blob/main/AGENTS.md) first.
+
+## License
+
+MIT. The bundled Geist Mono font is licensed separately under the SIL Open Font License 1.1; see `assets/fonts/OFL.txt`.

package/assets/fonts/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2024 The Geist Project Authors (https://github.com/vercel/geist-font)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/fonts/README.md

@@ -0,0 +1,17 @@
+# Bundled fonts
+
+## GeistMono[wght].ttf
+
+Geist Mono, variable weight axis, upstream `vercel/geist-font` release `v1.7.2`.
+Licensed under the SIL Open Font License 1.1. The full license text is in `OFL.txt`
+and must stay next to the font file in any redistribution.
+
+Takumi bundles Geist (sans) at weights 300 to 800 but **not** Geist Mono, verified in
+spike S4 (`docs/spikes/2026-09-11-takumi-s1-s2-s4.md`). The code card and the
+`brand.fonts.mono` default both need a mono face, so Shipseal ships one.
+
+One variable file covers every weight: rendering weights 300 through 900 produced
+seven distinct outputs, so there is no reason to ship static instances.
+
+To upgrade, take the file from a tagged upstream release, update the version above,
+and re-run the golden image tests.

package/dist/cli.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+//#region src/cli.ts
+process.stdout.write([
+	"shipseal is pre-alpha and not usable yet.",
+	"",
+	"This release exists to reserve the package name. No commands are implemented.",
+	`Follow progress at https://shipseal.dev`,
+	""
+].join("\n"));
+
+//#endregion
+export {  };
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n// CLI entry: parse args, dispatch to commands/*\n// Spec: docs/PROJECT_PLAN.md §18\n// Placeholder until the commands land. Keep this honest: it must not pretend to work.\n\nconst HOMEPAGE = \"https://shipseal.dev\";\n\nprocess.stdout.write(\n  [\n    \"shipseal is pre-alpha and not usable yet.\",\n    \"\",\n    \"This release exists to reserve the package name. No commands are implemented.\",\n    `Follow progress at ${HOMEPAGE}`,\n    \"\",\n  ].join(\"\\n\"),\n);\n"],"mappings":";;AAOA,QAAQ,OAAO,MACb;CACE;CACA;CACA;CACA;CACA;AACF,CAAC,CAAC,KAAK,IAAI,CACb"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "shipseal",
+  "version": "0.0.1",
+  "description": "Every release, sealed and ready to share. Verified release visuals from your repo.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "shipseal": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "assets"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "homepage": "https://shipseal.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/akii09/shipseal.git",
+    "directory": "packages/shipseal"
+  },
+  "keywords": [
+    "release",
+    "og-image",
+    "social-cards",
+    "changelog",
+    "github-action",
+    "takumi"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:update-golden": "UPDATE_GOLDEN=1 vitest run test/golden",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.2",
+    "tsdown": "^0.23.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
+  },
+  "dependencies": {
+    "takumi-js": "2.13.7",
+    "zod": "4.6.2"
+  }
+}