npm - create-yss-spec - Versions diffs - 2.1.5 → 2.1.7 - Mend

create-yss-spec 2.1.5 → 2.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3444) hide show

package/template/.codex/skills/drawio/references/docs/design-system/icons.md DELETED Viewed

@@ -1,332 +0,0 @@
-# Icon Libraries
-The Design System provides integration with cloud provider icons and technical symbols for professional architecture diagrams.
----
-## Cloud Provider Icons
-### AWS (Amazon Web Services)
-Icons use the `mxgraph.aws4.*` shape prefix.
-#### Compute
-| Service | Icon Reference | Shape                  |
-| ------- | -------------- | ---------------------- |
-| Lambda  | `aws.lambda`   | `mxgraph.aws4.lambda`  |
-| EC2     | `aws.ec2`      | `mxgraph.aws4.ec2`     |
-| ECS     | `aws.ecs`      | `mxgraph.aws4.ecs`     |
-| EKS     | `aws.eks`      | `mxgraph.aws4.eks`     |
-| Fargate | `aws.fargate`  | `mxgraph.aws4.fargate` |
-#### Storage & Database
-| Service     | Icon Reference    | Shape                      |
-| ----------- | ----------------- | -------------------------- |
-| S3          | `aws.s3`          | `mxgraph.aws4.s3`          |
-| DynamoDB    | `aws.dynamodb`    | `mxgraph.aws4.dynamodb`    |
-| RDS         | `aws.rds`         | `mxgraph.aws4.rds`         |
-| ElastiCache | `aws.elasticache` | `mxgraph.aws4.elasticache` |
-#### Networking
-| Service     | Icon Reference    | Shape                                    |
-| ----------- | ----------------- | ---------------------------------------- |
-| API Gateway | `aws.api-gateway` | `mxgraph.aws4.api_gateway`               |
-| CloudFront  | `aws.cloudfront`  | `mxgraph.aws4.cloudfront`                |
-| Route 53    | `aws.route53`     | `mxgraph.aws4.route_53`                  |
-| VPC         | `aws.vpc`         | `mxgraph.aws4.vpc`                       |
-| ALB         | `aws.alb`         | `mxgraph.aws4.application_load_balancer` |
-#### Integration
-| Service        | Icon Reference       | Shape                         |
-| -------------- | -------------------- | ----------------------------- |
-| SQS            | `aws.sqs`            | `mxgraph.aws4.sqs`            |
-| SNS            | `aws.sns`            | `mxgraph.aws4.sns`            |
-| EventBridge    | `aws.eventbridge`    | `mxgraph.aws4.eventbridge`    |
-| Step Functions | `aws.step-functions` | `mxgraph.aws4.step_functions` |
----
-### GCP (Google Cloud Platform)
-Icons use the `mxgraph.gcp2.*` shape prefix.
-#### Compute
-| Service         | Icon Reference  | Shape                            |
-| --------------- | --------------- | -------------------------------- |
-| Cloud Run       | `gcp.cloud-run` | `mxgraph.gcp2.cloud_run`         |
-| Cloud Functions | `gcp.functions` | `mxgraph.gcp2.cloud_functions`   |
-| Compute Engine  | `gcp.compute`   | `mxgraph.gcp2.compute_engine`    |
-| GKE             | `gcp.gke`       | `mxgraph.gcp2.kubernetes_engine` |
-#### Storage & Database
-| Service       | Icon Reference  | Shape                        |
-| ------------- | --------------- | ---------------------------- |
-| Cloud Storage | `gcp.storage`   | `mxgraph.gcp2.cloud_storage` |
-| Cloud SQL     | `gcp.sql`       | `mxgraph.gcp2.cloud_sql`     |
-| Firestore     | `gcp.firestore` | `mxgraph.gcp2.firestore`     |
-| BigQuery      | `gcp.bigquery`  | `mxgraph.gcp2.bigquery`      |
-#### Networking
-| Service              | Icon Reference | Shape                               |
-| -------------------- | -------------- | ----------------------------------- |
-| Cloud Load Balancing | `gcp.lb`       | `mxgraph.gcp2.cloud_load_balancing` |
-| Cloud CDN            | `gcp.cdn`      | `mxgraph.gcp2.cloud_cdn`            |
-| Cloud DNS            | `gcp.dns`      | `mxgraph.gcp2.cloud_dns`            |
----
-### Azure (Microsoft Azure)
-Icons use the `mxgraph.azure.*` shape prefix.
-#### Compute
-| Service     | Icon Reference      | Shape                               |
-| ----------- | ------------------- | ----------------------------------- |
-| Functions   | `azure.functions`   | `mxgraph.azure.functions`           |
-| App Service | `azure.app-service` | `mxgraph.azure.app_services`        |
-| AKS         | `azure.aks`         | `mxgraph.azure.kubernetes_services` |
-| VM          | `azure.vm`          | `mxgraph.azure.virtual_machine`     |
-#### Storage & Database
-| Service      | Icon Reference | Shape                        |
-| ------------ | -------------- | ---------------------------- |
-| Blob Storage | `azure.blob`   | `mxgraph.azure.blob_storage` |
-| SQL Database | `azure.sql`    | `mxgraph.azure.sql_database` |
-| Cosmos DB    | `azure.cosmos` | `mxgraph.azure.cosmos_db`    |
----
-## DevOps Icons
-### Container & Orchestration
-| Tool       | Icon Reference      | Shape                           |
-| ---------- | ------------------- | ------------------------------- |
-| Docker     | `devops.docker`     | `mxgraph.docker.docker`         |
-| Kubernetes | `devops.kubernetes` | `mxgraph.kubernetes.kubernetes` |
-| Helm       | `devops.helm`       | Custom SVG                      |
-### CI/CD
-| Tool           | Icon Reference          | Shape      |
-| -------------- | ----------------------- | ---------- |
-| GitHub Actions | `devops.github-actions` | Custom SVG |
-| Jenkins        | `devops.jenkins`        | Custom SVG |
-| GitLab CI      | `devops.gitlab`         | Custom SVG |
-| ArgoCD         | `devops.argocd`         | Custom SVG |
----
-## Lobe, Brand, and Lucide Image Icons
-Use `lobe.*` or `ai.*` for AI/LLM product identity icons that draw.io does not
-ship as native stencils. Common icons such as OpenAI, Claude, and Gemini render
-as embedded normalized SVGs for stable offline export. Unsupported names fail
-shape validation instead of producing remote image links.
-`brand.openai` is kept as a compatibility alias for `lobe.openai`; `brand.redis`
-uses an embedded SVG because Redis is not an AI/LLM logo.
-Lobe icon assets come from the MIT-licensed
-[Lobe Icons](https://github.com/lobehub/lobe-icons) project. Lobe and Lucide
-license texts ship under [`assets/licenses`](../../../assets/licenses/).
-| Need               | Icon Reference                             | Rendering               |
-| ------------------ | ------------------------------------------ | ----------------------- |
-| OpenAI             | `lobe.openai`, `ai.openai`, `brand.openai` | Embedded Lobe SVG image |
-| Claude / Anthropic | `lobe.claude`, `ai.anthropic`              | Embedded Lobe SVG image |
-| Gemini             | `lobe.gemini`                              | Embedded Lobe SVG image |
-| Redis              | `brand.redis`                              | Embedded SVG image      |
-Use `lucide.*` for the curated generic semantic fallback set bundled with this
-skill. The resolver embeds matching SVG data as data URI images, so these icons
-do not need package installation or network access. Use the documented
-kebab-case names, such as
-`lucide.alarm-clock`, `lucide.server-cog`, or `lucide.workflow`.
-Lucide icons are intentionally not brand logos; they are best for roles such as
-AI service, cache, document, server, workflow, and security.
-| Need                  | Icon Reference                       |
-| --------------------- | ------------------------------------ |
-| AI / LLM service      | `lucide.brain-circuit`, `lucide.bot` |
-| Cache / fast database | `lucide.database-zap`                |
-| Database              | `lucide.database`                    |
-| Document processing   | `lucide.file-text`                   |
-| Cloud service         | `lucide.cloud`                       |
-| Server / compute      | `lucide.server`, `lucide.cpu`        |
-| Server operations     | `lucide.server-cog`                  |
-| Workflow / pipeline   | `lucide.workflow`                    |
-| Security boundary     | `lucide.shield`                      |
-| Network               | `lucide.network`                     |
-> For the agentic node types (`llm`, `agent`, `vector_store`, `memory`, `tool`, `gateway`) and
-> their recommended icon pairings, see the Agentic / LLM System Vocabulary table in
-> [shapes.md](shapes.md). Icons here are not duplicated there.
-```yaml
-nodes:
-  - id: openai
-    label: OpenAI document understanding
-    icon: lobe.openai
-  - id: claude
-    label: Claude reasoning
-    icon: ai.anthropic
-  - id: cache
-    label: Semantic cache
-    icon: lucide.database-zap
-  - id: ops
-    label: Server operations
-    icon: lucide.server-cog
-```
-Resolution order for icon-heavy diagrams:
-1. Prefer draw.io provider stencils for cloud/vendor infrastructure
-   (`aws.*`, `gcp.*`, `azure.*`, `cisco.*`).
-2. Use `lobe.*` or `ai.*` for AI/LLM product identity icons.
-3. Use `brand.*` for supported non-AI brand fallbacks such as Redis.
-4. Use `lucide.*` for generic semantic icons, not official logos.
----
-## ML/AI Icons
-### Neural Network Symbols
-| Symbol       | Icon Reference | Description            |
-| ------------ | -------------- | ---------------------- |
-| Input Layer  | `ml.input`     | Circle with arrows in  |
-| Hidden Layer | `ml.hidden`    | Stacked circles        |
-| Output Layer | `ml.output`    | Circle with arrows out |
-| Convolution  | `ml.conv`      | Grid pattern           |
-| Pooling      | `ml.pool`      | Shrinking grid         |
-### Data Pipeline
-| Symbol      | Icon Reference   | Description         |
-| ----------- | ---------------- | ------------------- |
-| Data Source | `ml.data-source` | Database with arrow |
-| Transform   | `ml.transform`   | Gears               |
-| Model       | `ml.model`       | Brain/network icon  |
-| Prediction  | `ml.predict`     | Target/bullseye     |
----
-## Usage
-### In Specification
-```yaml
-nodes:
-  - id: lambda
-    label: Order Handler
-    icon: aws.lambda
-  - id: db
-    label: Orders DB
-    icon: aws.dynamodb
-```
-### Icon Normalization
-The system normalizes common variations:
-| User Input    | Resolved To                |
-| ------------- | -------------------------- |
-| `api-gateway` | `mxgraph.aws4.api_gateway` |
-| `lambda`      | `mxgraph.aws4.lambda`      |
-| `s3`          | `mxgraph.aws4.s3`          |
-| `cloud-run`   | `mxgraph.gcp2.cloud_run`   |
-### Icon with Custom Size
-```yaml
-nodes:
-  - id: logo
-    label: AWS Lambda
-    icon: aws.lambda
-    size: large # 160×80 px with icon
-```
----
-## mxCell Style for Icons
-```xml
-<mxCell style="shape=mxgraph.aws4.lambda;
-  verticalLabelPosition=bottom;align=center;
-  outlineConnect=0;dashed=0;verticalAlign=top;
-  fillColor=#F58536;strokeColor=#ffffff;
-  html=1;" />
-```
-Key properties:
-- `shape`: Icon shape reference
-- `verticalLabelPosition`: Label below icon (`bottom`)
-- `fillColor`: Icon fill (AWS orange for Lambda)
----
-## Best Practices
-### Cloud and Network Audit
-- Treat vendor icon color as identity: do not recolor a provider icon to make it fit a theme. Use a neutral semantic shape when the color would conflict with the diagram's color policy.
-- Nest provider boundaries in their real order: cloud/account/region, then VPC, availability zone, and subnet. Do not use an icon as a substitute for a missing ownership or network boundary.
-- Search first for every provider or device icon. A familiar-looking raw name is not evidence that draw.io ships it.
-### Consistency
-- Use same cloud provider icons throughout diagram
-- Don't mix AWS and GCP icons unless showing multi-cloud
-### Labeling
-- Place labels below icons
-- Keep labels short (service name only)
-- Use tooltips for additional details
-### Size
-- Standard icon size: 60×60 px
-- With label: 80×90 px total
-- Keep icons same size for visual balance
-### Grouping
-- Group related services in modules
-- Use consistent spacing (32px between icons)
-- Align icons to 8px grid
----
-## Adding Custom Icons
-For icons not in built-in libraries:
-1. **Use SVG**: Import SVG as custom shape
-2. **Use Image**: Embed as base64 image
-3. **Use stencil**: Reference draw.io stencil library
-```yaml
-nodes:
-  - id: custom
-    label: Custom Service
-    style:
-      image: "data:image/svg+xml,..."
-      shape: image
-```

package/template/.codex/skills/drawio/references/docs/design-system/shapes.md DELETED Viewed

@@ -1,269 +0,0 @@
-# Semantic Shapes
-The Design System automatically maps semantic node types to appropriate draw.io shapes, ensuring consistent visual vocabulary across diagrams.
----
-## Shape Mapping
-### Automatic Detection
-When a node's label or type matches certain keywords, the system automatically selects the appropriate shape:
-| Semantic Type | Shape             | mxCell Style           | Keywords                                 |
-| ------------- | ----------------- | ---------------------- | ---------------------------------------- |
-| `service`     | Rounded Rectangle | `rounded=1`            | service, api, component, microservice    |
-| `database`    | Cylinder          | `shape=cylinder3`      | database, db, sql, storage, redis, mongo |
-| `decision`    | Diamond           | `shape=rhombus`        | decision, condition, if, check, gateway  |
-| `terminal`    | Stadium/Pill      | `rounded=1;arcSize=50` | start, begin, end, finish, stop          |
-| `queue`       | Parallelogram     | `shape=parallelogram`  | queue, buffer, kafka, rabbitmq, stream   |
-| `user`        | Circle/Ellipse    | `ellipse`              | user, actor, client, person              |
-| `document`    | Document          | `shape=document`       | document, report, file, log              |
-| `formula`     | Rectangle         | `rounded=1`            | formula, equation, $$, math              |
-| `process`     | Rectangle         | `rounded=1`            | process, task, action, step              |
-| `cloud`       | Cloud             | `shape=cloud`          | cloud, internet, external                |
-| `container`   | Swimlane          | `swimlane`             | container, module, group, layer          |
----
-## Agentic / LLM System Vocabulary
-For LLM-agent and RAG architectures, the following semantic types map fireworks-style
-concepts onto existing shape primitives (no new drawing code — only color and dash differ).
-Reuse the existing `graph`, `queue`, `user`, `document`, and `cloud` types for graph DBs,
-message streams, actors, files, and external services respectively.
-| Semantic Type      | Concept                     | Shape (reused primitive) | mxCell Style                    | Suggested Icon                   |
-| ------------------ | --------------------------- | ------------------------ | ------------------------------- | -------------------------------- |
-| `llm`              | LLM / foundation model      | Rounded Rectangle        | `rounded=1;arcSize=20`          | `lucide.brain-circuit`, `lobe.*` |
-| `agent`            | Agent / orchestrator        | Hexagon                  | `shape=hexagon`                 | `lucide.bot`                     |
-| `vector_store`     | Vector / embedding store    | Cylinder                 | `shape=cylinder3`               | `lucide.database-zap`            |
-| `memory`           | Short-term / working memory | Dashed Rounded Rectangle | `rounded=1;arcSize=20;dashed=1` | `lucide.brain`                   |
-| `tool`             | Tool / function / plugin    | Rounded Rectangle        | `rounded=1;arcSize=20`          | `lucide.wrench`                  |
-| `gateway`          | API gateway / ingress       | Hexagon                  | `shape=hexagon`                 | `lucide.git-fork`                |
-| (reuse) `graph`    | Graph / knowledge DB        | Rounded Rectangle        | —                               | `lucide.workflow`                |
-| (reuse) `queue`    | Queue / stream              | Parallelogram            | —                               | —                                |
-| (reuse) `document` | File                        | Document                 | —                               | —                                |
-| (reuse) `cloud`    | External service            | Cloud                    | —                               | —                                |
-The dashed border on `memory` encodes ephemerality. `agent` and `gateway` share the hexagon
-primitive and are told apart by theme color. See [icons.md](icons.md) for the AI icon set
-(cross-referenced, not duplicated here) and [connectors.md](connectors.md) for the arrow
-semantics that pair with these nodes.
----
-## Usage
-### Explicit Type
-Specify the semantic type directly in the specification:
-```yaml
-nodes:
-  - id: db
-    label: User Database
-    type: database # → Cylinder shape
-```
-### Auto-Detection
-If no type is specified, the system analyzes the label:
-```yaml
-nodes:
-  - id: db
-    label: PostgreSQL Storage # Contains "storage" → database type
-```
-Detection priority:
-1. Explicit `type` field (highest)
-2. Label keyword matching
-3. Default to `service` (rounded rectangle)
----
-## Shape Styles by Theme
-Each theme defines colors for semantic shapes:
-### Tech Blue
-| Type     | Fill      | Stroke    |
-| -------- | --------- | --------- |
-| service  | `#DBEAFE` | `#2563EB` |
-| database | `#D1FAE5` | `#059669` |
-| decision | `#FEF3C7` | `#D97706` |
-| terminal | `#F1F5F9` | `#64748B` |
-| queue    | `#EDE9FE` | `#7C3AED` |
-| user     | `#E0F2FE` | `#0284C7` |
-| document | `#FFFFFF` | `#CBD5E1` |
-| formula  | `#FFFFFF` | `#2563EB` |
-### Academic
-All shapes use white fill with black stroke for grayscale compatibility.
-### Nature
-| Type     | Fill      | Stroke    |
-| -------- | --------- | --------- |
-| service  | `#D1FAE5` | `#059669` |
-| database | `#ECFCCB` | `#84CC16` |
-| decision | `#FEF9C3` | `#CA8A04` |
-### Dark Mode
-| Type     | Fill      | Stroke    |
-| -------- | --------- | --------- |
-| service  | `#1E3A5F` | `#60A5FA` |
-| database | `#064E3B` | `#34D399` |
-| decision | `#713F12` | `#FBBF24` |
----
-## Size Variants
-Shapes support multiple size presets:
-| Size     | Width | Height | Usage                   |
-| -------- | ----- | ------ | ----------------------- |
-| `small`  | 80px  | 40px   | Compact diagrams, icons |
-| `medium` | 120px | 60px   | **Default**             |
-| `large`  | 160px | 80px   | Emphasized nodes        |
-| `xl`     | 200px | 100px  | Major components        |
-```yaml
-nodes:
-  - id: main
-    label: Main Service
-    size: large # 160×80 px
-```
----
-## mxCell Style Reference
-### Rounded Rectangle (service)
-```xml
-<mxCell style="rounded=1;whiteSpace=wrap;html=1;arcSize=20;
-  fillColor=#DBEAFE;strokeColor=#2563EB;strokeWidth=1.5;
-  fontColor=#1E293B;fontSize=13;fontFamily=Inter;" />
-```
-### Cylinder (database)
-```xml
-<mxCell style="shape=cylinder3;whiteSpace=wrap;html=1;
-  boundedLbl=1;backgroundOutline=1;size=15;
-  fillColor=#D1FAE5;strokeColor=#059669;strokeWidth=1.5;
-  fontColor=#1E293B;fontSize=13;" />
-```
-### Diamond (decision)
-```xml
-<mxCell style="rhombus;whiteSpace=wrap;html=1;
-  fillColor=#FEF3C7;strokeColor=#D97706;strokeWidth=1.5;
-  fontColor=#1E293B;fontSize=13;" />
-```
-### Stadium/Pill (terminal)
-```xml
-<mxCell style="rounded=1;whiteSpace=wrap;html=1;arcSize=50;
-  fillColor=#F1F5F9;strokeColor=#64748B;strokeWidth=1.5;
-  fontColor=#1E293B;fontSize=13;" />
-```
-### Parallelogram (queue)
-```xml
-<mxCell style="shape=parallelogram;perimeter=parallelogramPerimeter;
-  whiteSpace=wrap;html=1;fixedSize=1;
-  fillColor=#EDE9FE;strokeColor=#7C3AED;strokeWidth=1.5;" />
-```
-### Ellipse (user)
-```xml
-<mxCell style="ellipse;whiteSpace=wrap;html=1;
-  fillColor=#E0F2FE;strokeColor=#0284C7;strokeWidth=1.5;
-  fontColor=#1E293B;fontSize=13;" />
-```
-### Document
-```xml
-<mxCell style="shape=document;whiteSpace=wrap;html=1;
-  boundedLbl=1;
-  fillColor=#FFFFFF;strokeColor=#CBD5E1;strokeWidth=1.5;" />
-```
-### Cloud
-```xml
-<mxCell style="ellipse;shape=cloud;whiteSpace=wrap;html=1;
-  fillColor=#F1F5F9;strokeColor=#64748B;strokeWidth=1.5;" />
-```
----
-## Custom Shapes
-For shapes not covered by semantic types, use explicit style overrides:
-```yaml
-nodes:
-  - id: custom
-    label: Custom Node
-    style:
-      shape: hexagon
-      fillColor: "#FEE2E2"
-      strokeColor: "#DC2626"
-```
-Available shapes in draw.io:
-- `rectangle`, `ellipse`, `rhombus`, `triangle`
-- `hexagon`, `parallelogram`, `trapezoid`
-- `cylinder3`, `cube`, `document`, `cloud`
-- `step`, `tape`, `note`, `card`
-- `actor`, `umlActor`, `folder`
----
-## Cloud Provider Shapes
-For cloud architecture diagrams, use icon references:
-```yaml
-nodes:
-  - id: lambda
-    label: Lambda Function
-    icon: aws.lambda # Uses mxgraph.aws4.lambda shape
-```
-See [icons.md](icons.md) for cloud provider icon references.
----
-## Formula Shapes
-Formula nodes have special styling to accommodate LaTeX rendering:
-```yaml
-nodes:
-  - id: eq1
-    label: "$$E = mc^2$$"
-    type: formula
-```
-Style characteristics:
-- White fill for readability
-- Thin blue border
-- Auto-sized based on formula complexity
-- Serif font family for math notation