packet-tracer-skill 0.1.0 → 0.2.0

package/examples/index.json

@@ -0,0 +1,127 @@
+{
+  "curated_examples": [
+    {
+      "name": "complex_campus_master_edit_v4",
+      "title": "Complex Campus",
+      "scenario_family": "campus",
+      "summary": "Management VLAN, Telnet, ACL, DNS, email, AAA, and multi-SSID wireless campus edit.",
+      "capabilities": [
+        "management_vlan",
+        "telnet",
+        "acl",
+        "server_dns",
+        "server_email",
+        "server_aaa",
+        "wireless_mutation"
+      ],
+      "primary_capabilities": [
+        "management_vlan",
+        "telnet",
+        "acl",
+        "server_dns",
+        "server_email",
+        "server_aaa",
+        "wireless_mutation"
+      ],
+      "acceptance_rank": 3,
+      "acceptance_label": "known_working_example",
+      "acceptance_excerpt": "known_working_example | donor=donor-backed | capabilities=management_vlan, telnet, acl",
+      "donor_origin": "donor-backed",
+      "fixture_name": "campus_core_complex",
+      "matrix_excerpt": "campus_core_complex | known_working_example | family=campus",
+      "parity_excerpt": "management_vlan=generate-ready, telnet=generate-ready, acl=generate-ready",
+      "decision_excerpt": "decision=known_working_example | donor_origin=donor-backed",
+      "runtime_excerpt": "runtime=donor-backed example artifact",
+      "inventory_json": "examples/complex_campus_master_edit_v4.inventory.json",
+      "screenshots": [
+        "examples/screenshots/complex_campus_master_edit_v4.png"
+      ],
+      "screenshot_count": 1,
+      "screenshot": "examples/screenshots/complex_campus_master_edit_v4.png",
+      "detail_images": [],
+      "preview": "examples/previews/complex_campus_master_edit_v4.svg",
+      "image": "examples/screenshots/complex_campus_master_edit_v4.png"
+    },
+    {
+      "name": "home_iot_cli_edit_v1",
+      "title": "Home IoT",
+      "scenario_family": "home_iot",
+      "summary": "Home gateway and IoT device onboarding with gateway-backed registration state.",
+      "capabilities": [
+        "iot",
+        "iot_registration",
+        "wireless_ap"
+      ],
+      "primary_capabilities": [
+        "iot",
+        "iot_registration",
+        "wireless_ap"
+      ],
+      "acceptance_rank": 3,
+      "acceptance_label": "known_working_example",
+      "acceptance_excerpt": "known_working_example | donor=donor-backed | capabilities=iot, iot_registration, wireless_ap",
+      "donor_origin": "donor-backed",
+      "fixture_name": "home_iot_complex",
+      "matrix_excerpt": "home_iot_complex | known_working_example | family=home_iot",
+      "parity_excerpt": "iot=generate-ready, iot_registration=generate-ready, wireless_ap=generate-ready",
+      "decision_excerpt": "decision=known_working_example | donor_origin=donor-backed",
+      "runtime_excerpt": "runtime=donor-backed example artifact",
+      "inventory_json": "examples/home_iot_cli_edit_v1.inventory.json",
+      "screenshots": [
+        "examples/screenshots/home_iot_cli_edit_v1.png"
+      ],
+      "screenshot_count": 1,
+      "screenshot": "examples/screenshots/home_iot_cli_edit_v1.png",
+      "detail_images": [],
+      "preview": "examples/previews/home_iot_cli_edit_v1.svg",
+      "image": "examples/screenshots/home_iot_cli_edit_v1.png"
+    },
+    {
+      "name": "service_heavy_cli_edit_v1",
+      "title": "Service Heavy",
+      "scenario_family": "service_heavy",
+      "summary": "Service-rich server lab with DNS, DHCP, FTP, email, syslog, AAA, and detailed service metadata.",
+      "capabilities": [
+        "server_dns",
+        "server_dhcp",
+        "server_ftp",
+        "server_email",
+        "server_syslog",
+        "server_aaa"
+      ],
+      "primary_capabilities": [
+        "server_dns",
+        "server_dhcp",
+        "server_ftp",
+        "server_email",
+        "server_syslog",
+        "server_aaa"
+      ],
+      "acceptance_rank": 3,
+      "acceptance_label": "known_working_example",
+      "acceptance_excerpt": "known_working_example | donor=donor-backed | capabilities=server_dns, server_dhcp, server_ftp",
+      "donor_origin": "donor-backed",
+      "fixture_name": "service_heavy_complex",
+      "matrix_excerpt": "service_heavy_complex | known_working_example | family=service_heavy",
+      "parity_excerpt": "server_dns=generate-ready, server_dhcp=generate-ready, server_ftp=generate-ready",
+      "decision_excerpt": "decision=known_working_example | donor_origin=donor-backed",
+      "runtime_excerpt": "runtime=donor-backed example artifact",
+      "inventory_json": "examples/service_heavy_cli_edit_v1.inventory.json",
+      "screenshots": [
+        "examples/screenshots/service_heavy_cli_edit_v1.png",
+        "examples/screenshots/service_heavy_cli_edit_v1_dhcp.png",
+        "examples/screenshots/service_heavy_cli_edit_v1_dns.png",
+        "examples/screenshots/service_heavy_cli_edit_v1_ftp.png"
+      ],
+      "screenshot_count": 4,
+      "screenshot": "examples/screenshots/service_heavy_cli_edit_v1.png",
+      "detail_images": [
+        "examples/screenshots/service_heavy_cli_edit_v1_dhcp.png",
+        "examples/screenshots/service_heavy_cli_edit_v1_dns.png",
+        "examples/screenshots/service_heavy_cli_edit_v1_ftp.png"
+      ],
+      "preview": "examples/previews/service_heavy_cli_edit_v1.svg",
+      "image": "examples/screenshots/service_heavy_cli_edit_v1.png"
+    }
+  ]
+}

package/examples/service_heavy_cli_edit_v1.inventory.json

@@ -0,0 +1,51 @@
+{
+  "example_name": "service_heavy_cli_edit_v1",
+  "source_mode": "donor-backed edit",
+  "scenario_family": "service_heavy",
+  "public_repo_policy": {
+    "commit_pkt_binary": false,
+    "commit_inventory_json": true,
+    "commit_screenshot": false
+  },
+  "artifact_paths": {
+    "inventory_json": "examples/service_heavy_cli_edit_v1.inventory.json",
+    "screenshot": "examples/screenshots/service_heavy_cli_edit_v1.png",
+    "screenshots": [
+      "examples/screenshots/service_heavy_cli_edit_v1.png",
+      "examples/screenshots/service_heavy_cli_edit_v1_dhcp.png",
+      "examples/screenshots/service_heavy_cli_edit_v1_dns.png",
+      "examples/screenshots/service_heavy_cli_edit_v1_ftp.png"
+    ]
+  },
+  "topology_summary": {
+    "core_server": "Server0",
+    "client_devices": [
+      "PC0",
+      "PC1"
+    ]
+  },
+  "service_summary": {
+    "Server0": [
+      "http_server",
+      "https_server",
+      "dns_server",
+      "dhcp_server",
+      "tftp_server",
+      "ftp_server",
+      "ntp_server",
+      "syslog_server",
+      "acs_server",
+      "email_server"
+    ]
+  },
+  "service_details": {
+    "Server0": {
+      "email_domain": "example.local",
+      "aaa_auth_port": "1812"
+    }
+  },
+  "verification_status": {
+    "inventory_roundtrip_verified": true,
+    "full_pytest_passed": true
+  }
+}

package/package.json

@@ -1,15 +1,39 @@
 {
   "name": "packet-tracer-skill",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": false,
-  "description": "Install and verify the pkt skill for Codex, Cursor, Claude Code, Kiro, AdaL, and custom skill hosts.",
+  "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": [
     "packet-tracer",
     "cisco",
+    "pkt",
+    "network-topology-generator",
+    "packet-tracer-generator",
+    "packet-tracer-editor",
+    "network-lab",
+    "network-automation",
+    "network-lab-generator",
+    "natural-language",
+    "prompt-to-topology",
+    "vlan",
+    "dhcp",
+    "dns",
+    "acl",
+    "nat",
+    "router-on-a-stick",
+    "telnet",
+    "wireless",
+    "ccna",
+    "ccnp",
     "skill",
+    "ai-skill",
+    "llm-skill",
     "codex",
     "cursor",
-    "claude"
+    "claude",
+    "gemini",
+    "github-copilot-skill",
+    "npx"
   ],
   "license": "MIT",
   "repository": {
@@ -23,18 +47,31 @@
   "bin": {
     "packet-tracer-skill": "bin/packet-tracer-skill.js"
   },
+  "scripts": {
+    "test": "python -m pytest tests -q",
+    "test:python": "python -m pytest tests -q",
+    "examples:build": "python scripts/build_examples_index.py",
+    "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",
+    "CONTRIBUTING.md",
+    "CHANGELOG.md",
+    "CITATION.cff",
+    "SECURITY.md",
+    "CODE_OF_CONDUCT.md",
     "requirements.txt",
     "requirements-dev.txt",
     "scripts",
     "templates",
     "references",
     "examples",
-    "bin"
+    "bin",
+    "docs"
   ],
   "engines": {
     "node": ">=18"

package/references/curated-donor-registry.json

@@ -0,0 +1,71 @@
+{
+  "registry_version": "1.0",
+  "donors": [
+    {
+      "relative_path": "complex_campus_master_edit_v4.pkt",
+      "promotion_status": "acceptance_verified_curated",
+      "packet_tracer_version": "9.0.0.0810",
+      "workspace_validation": "inventory_roundtrip_verified",
+      "apply_safety_level": "acceptance-verified",
+      "archetype_tags": ["campus/core", "wireless-heavy"],
+      "validated_edit_capabilities": [
+        "management_vlan",
+        "telnet",
+        "acl",
+        "server_dns",
+        "server_email",
+        "server_aaa",
+        "wireless_mutation"
+      ],
+      "acceptance_fixtures": ["campus_core_complex"],
+      "acceptance_notes": [
+        "Known working campus example with public screenshot and inventory artifact.",
+        "Use when donor root contains the exported complex campus .pkt example."
+      ],
+      "provenance": "known-working-example:complex_campus_master_edit_v4"
+    },
+    {
+      "relative_path": "home_iot_cli_edit_v1.pkt",
+      "promotion_status": "acceptance_verified_curated",
+      "packet_tracer_version": "9.0.0.0810",
+      "workspace_validation": "inventory_roundtrip_verified",
+      "apply_safety_level": "acceptance-verified",
+      "archetype_tags": ["IoT/home gateway", "wireless-heavy"],
+      "validated_edit_capabilities": [
+        "iot",
+        "iot_registration",
+        "iot_control",
+        "wireless_ap"
+      ],
+      "acceptance_fixtures": ["home_iot_complex"],
+      "acceptance_notes": [
+        "Known working home IoT example with gateway-backed registration state.",
+        "Use when donor root contains the exported Home IoT showcase lab."
+      ],
+      "provenance": "known-working-example:home_iot_cli_edit_v1"
+    },
+    {
+      "relative_path": "service_heavy_cli_edit_v1.pkt",
+      "promotion_status": "acceptance_verified_curated",
+      "packet_tracer_version": "9.0.0.0810",
+      "workspace_validation": "inventory_roundtrip_verified",
+      "apply_safety_level": "acceptance-verified",
+      "archetype_tags": ["service-heavy"],
+      "validated_edit_capabilities": [
+        "server_dns",
+        "server_dhcp",
+        "server_ftp",
+        "server_email",
+        "server_syslog",
+        "server_aaa",
+        "end_device_mutation"
+      ],
+      "acceptance_fixtures": ["service_heavy_complex"],
+      "acceptance_notes": [
+        "Known working service-heavy example with topology and service detail screenshots.",
+        "Use when donor root contains the exported service-heavy showcase lab."
+      ],
+      "provenance": "known-working-example:service_heavy_cli_edit_v1"
+    }
+  ]
+}

package/references/scenario-fixture-corpus.json

@@ -0,0 +1,53 @@
+{
+  "fixture_registry_version": "1.0",
+  "fixtures": [
+    {
+      "name": "campus_core_complex",
+      "scenario_family": "campus",
+      "preferred_donor_archetypes": ["campus/core"],
+      "critical_capabilities": ["router_on_a_stick", "trunk", "management_vlan", "telnet", "acl", "nat"],
+      "minimum_expectations": {
+        "requires_family_match": true,
+        "requires_nonempty_summary": true,
+        "requires_nonempty_matrix_row": true
+      },
+      "canonical_prompt": "6 şöbəli kampus, VLAN 10 20 30 40 50 60, management VLAN 99, Telnet, ACL, NAT, printer, wireless AP/client, router-on-a-stick"
+    },
+    {
+      "name": "service_heavy_complex",
+      "scenario_family": "service_heavy",
+      "preferred_donor_archetypes": ["service-heavy"],
+      "critical_capabilities": ["server_dns", "server_dhcp", "server_http", "server_https", "server_ftp", "server_tftp", "server_email", "server_syslog", "server_aaa", "ntp"],
+      "minimum_expectations": {
+        "requires_family_match": true,
+        "requires_nonempty_summary": true,
+        "requires_nonempty_matrix_row": true
+      },
+      "canonical_prompt": "server yönümlü lab, DNS, DHCP, HTTP, HTTPS, FTP, TFTP, NTP, email, syslog, AAA, end-device DNS/IP mutation"
+    },
+    {
+      "name": "home_iot_complex",
+      "scenario_family": "home_iot",
+      "preferred_donor_archetypes": ["IoT/home gateway", "wireless-heavy"],
+      "critical_capabilities": ["iot", "iot_registration", "iot_control", "wireless_ap"],
+      "minimum_expectations": {
+        "requires_family_match": true,
+        "requires_nonempty_summary": true,
+        "requires_nonempty_matrix_row": true
+      },
+      "canonical_prompt": "smart home, home gateway, IoT registration, IoT control, wireless edge"
+    },
+    {
+      "name": "wan_security_complex",
+      "scenario_family": "wan_security_edge",
+      "preferred_donor_archetypes": ["WAN/security edge"],
+      "critical_capabilities": ["vpn", "ipsec", "gre", "ppp", "multilayer_switching", "security_edge"],
+      "minimum_expectations": {
+        "requires_family_match": true,
+        "requires_nonempty_summary": true,
+        "requires_nonempty_matrix_row": true
+      },
+      "canonical_prompt": "wan security edge, multilayer switch, cloud, firewall/ASA, GRE, PPP, site-to-site VPN, IPsec, ACL, NAT"
+    }
+  ]
+}