packet-tracer-skill 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -4,7 +4,25 @@ All notable changes to this project should be recorded in this file.
 
 The format is intentionally simple and release-oriented.
 
-## [0.2.0]
+## [0.2.1]
+
+### Added
+
+- npm tarball hardening for the public package surface
+- launch announcement draft aligned with the current public release wording
+
+### Changed
+
+- package version advanced to `0.2.1` because `0.2.0` is already published on npm
+- npm package contents now exclude caches, generated previews, and non-essential screenshot payloads
+- public release references now consistently point to the `0.2.1` patch release artifacts
+
+### Notes
+
+- `0.2.1` is the publishable patch release for the conservative public preview surface
+- runtime messaging remains Windows-first and explicit about the external bridge-assisted validation path
+
+## [0.2.0]
 
 ### Added
 
@@ -14,7 +32,7 @@ The format is intentionally simple and release-oriented.
 - runtime truth, discovery keyword, GitHub metadata, publish-preview roadmap, and curated donor registry docs
 - seeded curated donor registry entries derived from known working public example artifacts
 - checked-in Packet Tracer template fallback assets for hermetic builder coverage
-- hero demo plan and `0.2.0` release notes draft artifacts for conservative launch prep
+- hero demo plan and `0.2.0` release notes draft artifacts for conservative launch prep
 
 ### Changed
 

package/README.md

@@ -8,7 +8,7 @@ Cisco Packet Tracer 9.x `.pkt` generator and editor for skill-based coding hosts
 
 This repository is built for one job: take a natural-language network request, build an explicit scenario-aware plan, adapt a compatible donor lab, and produce a Packet Tracer 9.x workflow that stays open-first and compatibility-first.
 
-`0.2.0` public preview prep is focused on:
+`0.2.1` public preview hardening is focused on:
 
 - donor-backed and scenario-aware public messaging
 - conservative Windows-first runtime truth
@@ -101,7 +101,7 @@ powershell -ExecutionPolicy Bypass -File .\scripts\setup.ps1 -Dev
 
 Launch-prep references:
 
-- [docs/release-notes-0.2.0.md](docs/release-notes-0.2.0.md)
+- [docs/release-notes-0.2.1.md](docs/release-notes-0.2.1.md)
 - [docs/hero-demo-plan.md](docs/hero-demo-plan.md)
 - [docs/github-metadata.md](docs/github-metadata.md)
 - [docs/release-checklist.md](docs/release-checklist.md)
@@ -234,7 +234,7 @@ Primary screenshot:
 
 ![Packet Tracer topology](examples/screenshots/complex_campus_master_edit_v4.png)
 
-Hero visual for the `0.2.0` launch-prep surface:
+Hero visual for the `0.2.1` public preview surface:
 
 - `examples/screenshots/complex_campus_master_edit_v4.png`
 
@@ -298,7 +298,7 @@ Bu repo təbii dil ilə Packet Tracer `.pkt` generate və edit etmək üçündü
 
 Hazırkı prioritet:
 
-- `0.2.0` public preview prep
+- `0.2.1` public preview hardening
 - release-ready və publish-ready surface
 - README / npm / GitHub discoverability hizalanması
 - scenario truth source, donor registry və runtime doctor contract consistency

package/docs/hero-demo-plan.md

@@ -2,7 +2,7 @@
 
 ## Goal
 
-Prepare one conservative hero demo flow for the `0.2.0` public preview surface without implying self-contained runtime readiness.
+Prepare one conservative hero demo flow for the `0.2.1` public preview surface without implying self-contained runtime readiness.
 
 ## Prompt
 
@@ -22,10 +22,12 @@ python .\scripts\generate_pkt.py --parity-report "6 department campus with route
 python .\scripts\runtime_doctor.py
 ```
 
-## Visual
-
-- pinned image: `examples/screenshots/complex_campus_master_edit_v4.png`
-- reuse the complex campus topology screenshot as the hero visual until a dedicated GIF is produced
+## Visual
+
+- pinned image: `examples/screenshots/complex_campus_master_edit_v4.png`
+- reuse the complex campus topology screenshot as the hero visual until a dedicated GIF is produced
+- alt text: `Donor-backed complex campus Packet Tracer topology with VLAN, management, ACL, and wireless edits`
+- visual label: `Complex Campus hero visual`
 
 ## Claims To Make
 
@@ -35,8 +37,14 @@ python .\scripts\runtime_doctor.py
 - Windows-first runtime
 - validated with external bridge override
 
-## Claims Not To Make
-
-- do not say the repo is self-contained runtime-ready
-- do not claim full synthetic generate for WAN/security coverage
-- do not imply unsupported or acceptance-gated mutations are generated anyway
+## Claims Not To Make
+
+- do not say the repo is self-contained runtime-ready
+- do not claim full synthetic generate for WAN/security coverage
+- do not imply unsupported or acceptance-gated mutations are generated anyway
+
+## Launch Caption
+
+Use this short caption when pairing the hero image with release notes or announcement text:
+
+`Donor-backed, open-first, scenario-aware Packet Tracer workflow with conservative Windows-first runtime truth.`

package/docs/launch-announcement-0.2.1.md

@@ -0,0 +1,15 @@
+# `0.2.1` Launch Announcement Draft
+
+## npm Publish Announcement
+
+`packet-tracer-skill 0.2.1` is live on npm.
+
+Donor-backed Cisco Packet Tracer 9.x skill for natural-language planning, open-first `.pkt` workflows, scenario-aware reporting, parity checks, and Windows-first runtime diagnostics.
+
+## GitHub Release Intro
+
+`0.2.1` is a conservative public preview patch release. It keeps the current donor-backed workflow, the scenario-aware decision layer, the runtime doctor contract, and the known working scenario set intact while tightening the published package surface.
+
+## Short Social Summary
+
+Published `packet-tracer-skill@0.2.1`: donor-backed, open-first, scenario-aware Packet Tracer workflow with parity reporting, runtime doctor output, and a known working scenario set. Windows-first runtime, validated with external bridge override.

package/docs/publish-preview-roadmap.md

@@ -11,8 +11,8 @@
 
 ## Step B: Public `0.2.x` Publish-Preview
 
-- `package.json` is versioned at `0.2.0`
-- release notes draft is ready: `docs/release-notes-0.2.0.md`
+- `package.json` is versioned at `0.2.1`
+- release notes draft is ready: `docs/release-notes-0.2.1.md`
 - hero visual is locked to `examples/screenshots/complex_campus_master_edit_v4.png`
 - hero demo execution plan is ready: `docs/hero-demo-plan.md`
 - GitHub About/Topics text is finalized in `docs/github-metadata.md`

package/docs/release-checklist.md

@@ -1,6 +1,6 @@
 # Release Checklist
 
-Target release surface: `0.2.0` conservative public preview prep.
+Target release surface: `0.2.1` conservative public preview.
 
 ## Product Contract
 
@@ -32,8 +32,8 @@ python .\scripts\runtime_doctor.py
 - raw `.pkt` binaries are not committed
 - examples index and gallery were rebuilt
 - screenshots are intentional and non-sensitive
-- changelog entry is updated for `0.2.0`
-- release notes draft exists: `docs/release-notes-0.2.0.md`
+- changelog entry is updated for `0.2.1`
+- release notes draft exists: `docs/release-notes-0.2.1.md`
 - hero demo plan exists: `docs/hero-demo-plan.md`
 - hero visual is selected: `examples/screenshots/complex_campus_master_edit_v4.png`
 - runtime truth docs match current `runtime_grade` and `bridge_resolution` semantics

package/docs/{release-notes-0.2.0.md → release-notes-0.2.1.md}

@@ -1,8 +1,8 @@
-# `packet-tracer-skill` `0.2.0` Release Notes Draft
+# `packet-tracer-skill` `0.2.1` Release Notes Draft
 
 ## Summary
 
-`0.2.0` is a conservative public preview prep release for `packet-tracer-skill`. It stabilizes the public release surface around donor-backed planning, open-first generation rules, scenario-aware reporting, and Windows-first runtime truth.
+`0.2.1` is a conservative public preview patch release for `packet-tracer-skill`. It hardens the npm package surface around donor-backed planning, open-first generation rules, scenario-aware reporting, and Windows-first runtime truth.
 
 ## Highlights
 

package/examples/README.md

@@ -2,7 +2,7 @@
 
 This repo keeps text-based example artifacts under `examples/` and treats them as a known working scenario set, not just a screenshot folder.
 
-For the `0.2.0` launch-prep surface, the canonical public set is:
+For the `0.2.1` public preview surface, the canonical public set is:
 
 - `complex_campus_master_edit_v4`
 - `home_iot_cli_edit_v1`
@@ -69,4 +69,4 @@ Gallery families:
 
 Launch-prep references:
 - `..\docs\hero-demo-plan.md`
-- `..\docs\release-notes-0.2.0.md`
+- `..\docs\release-notes-0.2.1.md`

package/examples/gallery.md

@@ -2,7 +2,7 @@
 
 These examples are public, text-first proof artifacts derived from donor-backed workflows and aligned with the scenario fixture corpus.
 
-`0.2.0` canonical public set:
+`0.2.1` canonical public set:
 
 - `campus`
 - `home_iot`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "packet-tracer-skill",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "private": false,
   "description": "Donor-backed Cisco Packet Tracer 9.x skill for natural-language planning, safe-open generation, editing, parity reporting, and runtime diagnostics across coding hosts.",
   "keywords": [
@@ -54,25 +54,43 @@
     "doctor": "node bin/packet-tracer-skill.js --doctor",
     "smoke:parity": "python scripts/generate_pkt.py --parity-report \"campus with VLAN DHCP ACL\""
   },
-  "files": [
-    "SKILL.md",
-    "LICENSE",
-    "LICENSES",
-    "README.md",
+  "files": [
+    "SKILL.md",
+    "LICENSE",
+    "LICENSES",
+    "README.md",
     "CONTRIBUTING.md",
     "CHANGELOG.md",
     "CITATION.cff",
     "SECURITY.md",
-    "CODE_OF_CONDUCT.md",
-    "requirements.txt",
-    "requirements-dev.txt",
-    "scripts",
-    "templates",
-    "references",
-    "examples",
-    "bin",
-    "docs"
-  ],
+    "CODE_OF_CONDUCT.md",
+    "requirements.txt",
+    "requirements-dev.txt",
+    "bin/packet-tracer-skill.js",
+    "scripts/*.py",
+    "scripts/*.ps1",
+    "scripts/vendor/README.md",
+    "scripts/vendor/twofish.py",
+    "templates",
+    "references/*.json",
+    "references/*.md",
+    "examples/README.md",
+    "examples/gallery.md",
+    "examples/index.json",
+    "examples/blueprint_minimal.json",
+    "examples/*.inventory.json",
+    "examples/screenshots/*.png",
+    "docs/curated-donor-registry.md",
+    "docs/discovery-keywords.md",
+    "docs/github-discussions-setup.md",
+    "docs/github-metadata.md",
+    "docs/hero-demo-plan.md",
+    "docs/launch-announcement-0.2.1.md",
+    "docs/publish-preview-roadmap.md",
+    "docs/release-checklist.md",
+    "docs/release-notes-0.2.1.md",
+    "docs/runtime-truth.md"
+  ],
   "engines": {
     "node": ">=18"
   }

package/scripts/build_examples_index.py

@@ -250,7 +250,7 @@ def build_examples_gallery_markdown(payload: dict[str, object]) -> str:
         "",
         "These examples are public, text-first proof artifacts derived from donor-backed workflows and aligned with the scenario fixture corpus.",
         "",
-        "`0.2.0` canonical public set:",
+        "`0.2.1` canonical public set:",
         "",
         "- `campus`",
         "- `home_iot`",

package/docs/screenshots/.gitkeep

@@ -1 +0,0 @@
-