@huaqiu/dsh-hqsch 0.4.8

package/skills/hqsch-scenario-b/docs/rpc/canvas-zoom-all.md

@@ -0,0 +1,92 @@
+---
+name: canvas-zoom-all
+metadata:
+  category: canvas
+  service: CanvasOpsService
+  method: ZoomAll
+  rpcKind: unary
+description: >-
+  Zoom All via CanvasOpsService.ZoomAll
+version: 0.1.0
+vendor: Huaqiu Electronics
+tags:
+  - eda
+  - huaqiu
+  - canvas
+entry: "@huaqiu/hqeda"
+manifest: "@huaqiu/hqeda/skill.json"
+inputSchema:
+  name: CanvasContextRequestSchema
+  namespace: HqServicesV1CanvasOpsService
+---
+
+# Zoom All
+
+Zoom All via CanvasOpsService.ZoomAll
+
+## Overview
+
+This skill provides access to the **`CanvasOpsService.ZoomAll`** RPC method on the Huaqiu EDA engine. It is part of the **canvas** domain and executes against the `canvasOps` client.
+
+| Property | Value |
+| --- | --- |
+| Skill ID | `canvas-zoom-all` |
+| Service | `CanvasOpsService` |
+| Method | `ZoomAll` |
+| Transport | Unary (unary) |
+| Domain | canvas |
+| Request type | `CanvasContextRequest` |
+| Response type | `SuccessResponse` |
+
+## Parameters
+
+| Name | Type | Required | Repeated | Description |
+| --- | --- | --- | --- | --- |
+| `context` | `ProjectContext` | no | no | — |
+
+## Response
+
+Returns a `SuccessResponse` message with the following fields:
+
+| Name | Type | Repeated | Description |
+| --- | --- | --- | --- |
+| `success` | `boolean` | no | — |
+
+## Response Example
+
+Representative response structure (field values are placeholders):
+
+```json
+{
+  "success": false
+}
+```
+
+## Prerequisites
+
+- [project-get-active-project](../../project/get-active-project/SKILL.md) — Discover the active project before building project-scoped context.
+
+See also [skill-dependencies.md](../../references/skill-dependencies.md) for common workflows.
+
+## How to Use
+
+Execute via the HQ EDA skill runtime with a connected `EditorClient`. See [quickstart.md](../../references/quickstart.md) for the full `listEditors` → `connect` → `getSkill` → `execute` chain.
+
+```typescript
+import { getSkill, toJsonString } from "@huaqiu/hqeda";
+
+const skill = getSkill("canvas-zoom-all");
+const result = await skill.execute({ client }, {
+  context: "<ProjectContext via client.createProjectContext('my-project')>",
+});
+console.log(toJsonString(result, { prettySpaces: 2 }));
+```
+
+Serialize responses with `toJsonString()` — see [serialization.md](../../references/serialization.md).
+
+## Related Skills
+
+- Other **canvas** skills: [`canvas/`](../)
+- Full index: [All EDA skills](../../SKILL.md)
+- Install: `npx skills add Huaqiu-Electronics/skills --path eda/canvas/zoom-all`
+

package/skills/hqsch-scenario-b/docs/rpc/find-find-object.md

@@ -0,0 +1,96 @@
+---
+name: find-find-object
+metadata:
+  category: find
+  service: FindService
+  method: FindObject
+  rpcKind: unary
+description: >-
+  Find Object via FindService.FindObject
+version: 0.1.0
+vendor: Huaqiu Electronics
+tags:
+  - eda
+  - huaqiu
+  - find
+entry: "@huaqiu/hqeda"
+manifest: "@huaqiu/hqeda/skill.json"
+inputSchema:
+  name: FindObjectRequestSchema
+  namespace: HqServicesV1FindService
+---
+
+# Find Object
+
+Find Object via FindService.FindObject
+
+## Overview
+
+This skill provides access to the **`FindService.FindObject`** RPC method on the Huaqiu EDA engine. It is part of the **find** domain and executes against the `find` client.
+
+| Property | Value |
+| --- | --- |
+| Skill ID | `find-find-object` |
+| Service | `FindService` |
+| Method | `FindObject` |
+| Transport | Unary (unary) |
+| Domain | find |
+| Request type | `FindObjectRequest` |
+| Response type | `FindObjectResponse` |
+
+## Parameters
+
+| Name | Type | Required | Repeated | Description |
+| --- | --- | --- | --- | --- |
+| `context` | `EditorContext` | no | no | — |
+| `findOptionUrl` | `string` | yes | no | — |
+| `showDock` | `boolean` | yes | no | — |
+
+## Response
+
+Returns a `FindObjectResponse` message with the following fields:
+
+| Name | Type | Repeated | Description |
+| --- | --- | --- | --- |
+| `success` | `boolean` | no | — |
+
+## Response Example
+
+Representative response structure (field values are placeholders):
+
+```json
+{
+  "success": false
+}
+```
+
+## Prerequisites
+
+- [project-get-active-project](../../project/get-active-project/SKILL.md) — Discover the active project before building project-scoped context.
+
+See also [skill-dependencies.md](../../references/skill-dependencies.md) for common workflows.
+
+## How to Use
+
+Execute via the HQ EDA skill runtime with a connected `EditorClient`. See [quickstart.md](../../references/quickstart.md) for the full `listEditors` → `connect` → `getSkill` → `execute` chain.
+
+```typescript
+import { getSkill, toJsonString } from "@huaqiu/hqeda";
+
+const skill = getSkill("find-find-object");
+const result = await skill.execute({ client }, {
+  context: "<ProjectContext via client.createProjectContext('my-project')>",
+  findOptionUrl: "example",
+  showDock: false,
+});
+console.log(toJsonString(result, { prettySpaces: 2 }));
+```
+
+Serialize responses with `toJsonString()` — see [serialization.md](../../references/serialization.md).
+
+## Related Skills
+
+- Other **find** skills: [`find/`](../)
+- Full index: [All EDA skills](../../SKILL.md)
+- Install: `npx skills add Huaqiu-Electronics/skills --path eda/find/find-object`
+

package/skills/hqsch-scenario-b/docs/rpc/kernel-get-snapshot.md

@@ -0,0 +1,104 @@
+---
+name: kernel-get-snapshot
+metadata:
+  category: kernel
+  service: KernelService
+  method: GetSnapshot
+  rpcKind: unary
+description: >-
+  Get Snapshot via KernelService.GetSnapshot
+version: 0.1.0
+vendor: Huaqiu Electronics
+tags:
+  - eda
+  - huaqiu
+  - kernel
+entry: "@huaqiu/hqeda"
+manifest: "@huaqiu/hqeda/skill.json"
+inputSchema:
+  name: GetSnapshotRequestSchema
+  namespace: HqServicesV1KernelService
+---
+
+# Get Snapshot
+
+Get Snapshot via KernelService.GetSnapshot
+
+## Overview
+
+This skill provides access to the **`KernelService.GetSnapshot`** RPC method on the Huaqiu EDA engine. It is part of the **kernel** domain and executes against the `kernel` client.
+
+| Property | Value |
+| --- | --- |
+| Skill ID | `kernel-get-snapshot` |
+| Service | `KernelService` |
+| Method | `GetSnapshot` |
+| Transport | Unary (unary) |
+| Domain | kernel |
+| Request type | `GetSnapshotRequest` |
+| Response type | `GetSnapshotResponse` |
+
+## Parameters
+
+| Name | Type | Required | Repeated | Description |
+| --- | --- | --- | --- | --- |
+| `context` | `ProjectContext` | no | no | — |
+| `atRevision` | `bigint` | yes | no | — |
+
+## Response
+
+Returns a `GetSnapshotResponse` message with the following fields:
+
+| Name | Type | Repeated | Description |
+| --- | --- | --- | --- |
+| `snapshot` | `KernelSnapshot` | no | — |
+
+## Usage Examples
+
+### get kernel snapshot for a discovered project
+
+```json
+{
+  "context": "<ProjectContext via client.createProjectContext('my-project')>"
+}
+```
+
+## Response Example
+
+Representative response structure (field values are placeholders):
+
+```json
+{
+  "snapshot": {}
+}
+```
+
+## Prerequisites
+
+- [project-get-active-project](../../project/get-active-project/SKILL.md) — Discover the active project before building project-scoped context.
+
+See also [skill-dependencies.md](../../references/skill-dependencies.md) for common workflows.
+
+## How to Use
+
+Execute via the HQ EDA skill runtime with a connected `EditorClient`. See [quickstart.md](../../references/quickstart.md) for the full `listEditors` → `connect` → `getSkill` → `execute` chain.
+
+```typescript
+import { getSkill, toJsonString } from "@huaqiu/hqeda";
+
+const skill = getSkill("kernel-get-snapshot");
+const result = await skill.execute({ client }, {
+  context: "<ProjectContext via client.createProjectContext('my-project')>",
+  atRevision: "0",
+});
+console.log(toJsonString(result, { prettySpaces: 2 }));
+```
+
+Serialize responses with `toJsonString()` — see [serialization.md](../../references/serialization.md).
+
+## Related Skills
+
+- Other **kernel** skills: [`kernel/`](../)
+- Full index: [All EDA skills](../../SKILL.md)
+- Install: `npx skills add Huaqiu-Electronics/skills --path eda/kernel/get-snapshot`
+

package/skills/hqsch-scenario-b/docs/rpc/netlist-get-active-page-net-list.md

@@ -0,0 +1,87 @@
+---
+name: netlist-get-active-page-net-list
+metadata:
+  category: netlist
+  service: NetListService
+  method: GetActivePageNetList
+  rpcKind: unary
+description: >-
+  / Gets the netlist for the currently active schematic page (real-time canvas state).
+version: 0.1.0
+vendor: Huaqiu Electronics
+tags:
+  - eda
+  - huaqiu
+  - netlist
+entry: "@huaqiu/hqeda"
+manifest: "@huaqiu/hqeda/skill.json"
+inputSchema:
+  name: EmptySchema
+  namespace: ProtobufWkt
+---
+
+# Get Active Page Net List
+
+/ Gets the netlist for the currently active schematic page (real-time canvas state).
+
+## Overview
+
+This skill provides access to the **`NetListService.GetActivePageNetList`** RPC method on the Huaqiu EDA engine. It is part of the **netlist** domain and executes against the `netList` client.
+
+| Property | Value |
+| --- | --- |
+| Skill ID | `netlist-get-active-page-net-list` |
+| Service | `NetListService` |
+| Method | `GetActivePageNetList` |
+| Transport | Unary (unary) |
+| Domain | netlist |
+| Request type | `Empty` |
+| Response type | `GetNetListResponse` |
+
+## Response
+
+Returns a `GetNetListResponse` message with the following fields:
+
+| Name | Type | Repeated | Description |
+| --- | --- | --- | --- |
+| `result` | `{
+    /**
+     * / Schematic netlist data.
+     *
+     * @generated from field: hq.ir.schematic.v1.SchematicNetlist netlist = 1;
+     */
+    value: SchematicNetlist;
+    case: "netlist";
+  }` | no | — |
+
+## Response Example
+
+Representative response structure (field values are placeholders):
+
+```json
+{
+  "result": {}
+}
+```
+
+## How to Use
+
+Execute via the HQ EDA skill runtime with a connected `EditorClient`. See [quickstart.md](../../references/quickstart.md) for the full `listEditors` → `connect` → `getSkill` → `execute` chain.
+
+```typescript
+import { getSkill, toJsonString } from "@huaqiu/hqeda";
+
+const skill = getSkill("netlist-get-active-page-net-list");
+const result = await skill.execute({ client }, {
+});
+console.log(toJsonString(result, { prettySpaces: 2 }));
+```
+
+Serialize responses with `toJsonString()` — see [serialization.md](../../references/serialization.md).
+
+## Related Skills
+
+- Other **netlist** skills: [`netlist/`](../)
+- Full index: [All EDA skills](../../SKILL.md)
+- Install: `npx skills add Huaqiu-Electronics/skills --path eda/netlist/get-active-page-net-list`
+

package/skills/hqsch-scenario-b/docs/rpc/netlist-get-port-pairing.md

@@ -0,0 +1,34 @@
+---
+name: netlist-get-port-pairing
+metadata:
+  category: netlist
+  service: NetListService
+  method: GetPortPairing
+---
+
+# netList.GetPortPairing
+
+Returns every cross-page / cross-occurrence Port and Off-page pairing that
+`VxPstxnetNew::ReadFromDesign` has already merged onto the same design net.
+
+## Why
+
+`GetProjectNetList` only exposes pin↔net. Agents cannot see that `/TYPE-C`
+`USB_D+` and `/ESP32-C3FH4` `GPIO18` are the same net without guessing.
+This RPC exposes the pairing and the merge rule.
+
+## Call
+
+```typescript
+const res = await client.netList.getPortPairing({});
+```
+
+## Rules (from net connectivity + ReadFromDesign)
+
+| Rule | Source | When |
+| --- | --- | --- |
+| `BY_NAME` | MergePageNet | Same Off-page / Port name within schematic folder |
+| `BY_HIERARCHY` | ConnectBlockPinAndPort | Parent block pin = `occPath_portName`; parent wires can join different child port names |
+| `BY_GLOBAL` | MergeDesignNet | Design-wide Power / Global name intersection |
+
+There is **no byGuid** rule.

package/skills/hqsch-scenario-b/docs/rpc/obj-place-place-pin-stub-wire-and-net-alias.md

@@ -0,0 +1,114 @@
+---
+name: obj-place-place-pin-stub-wire-and-net-alias
+metadata:
+  category: obj-place
+  service: ObjPlaceService
+  method: PlacePinStubWireAndNetAlias
+  rpcKind: unary
+description: >-
+  Pin stub wire + net alias: detect existing wire, extend stub with collision avoidance, place alias; single undo step.
+version: 0.1.0
+vendor: Huaqiu Electronics
+tags:
+  - eda
+  - huaqiu
+  - obj-place
+entry: "@huaqiu/hqeda"
+manifest: "@huaqiu/hqeda/skill.json"
+inputSchema:
+  name: PlacePinStubWireAndNetAliasRequestSchema
+  namespace: HqServicesV1ObjPlaceService
+---
+
+# Place Pin Stub Wire And Net Alias
+
+Pin stub wire + net alias: detect existing wire, extend stub with collision avoidance, place alias; single undo step.
+
+## Overview
+
+This skill provides access to the **`ObjPlaceService.PlacePinStubWireAndNetAlias`** RPC method on the Huaqiu EDA engine. It is part of the **obj-place** domain and executes against the `objPlace` client.
+
+| Property | Value |
+| --- | --- |
+| Skill ID | `obj-place-place-pin-stub-wire-and-net-alias` |
+| Service | `ObjPlaceService` |
+| Method | `PlacePinStubWireAndNetAlias` |
+| Transport | Unary (unary) |
+| Domain | obj-place |
+| Request type | `PlacePinStubWireAndNetAliasRequest` |
+| Response type | `PlacePinStubWireAndNetAliasResponse` |
+
+## Parameters
+
+| Name | Type | Required | Repeated | Description |
+| --- | --- | --- | --- | --- |
+| `context` | `ProjectContext` | no | no | — |
+| `objectId` | `bigint` | yes | no | part/symbol canvas id |
+| `pinNum` | `number` | yes | no | pin_num or pin_name (one required) |
+| `pinName` | `string` | yes | no | — |
+| `netName` | `string` | yes | no | — |
+| `snapToGrid` | `boolean` | yes | no | default true |
+| `initialStubLength` | `bigint` | yes | no | default 30 |
+| `stubExtendStep` | `bigint` | yes | no | default 10 |
+| `maxStubLength` | `bigint` | yes | no | default 300 |
+
+## Response
+
+Returns a `PlacePinStubWireAndNetAliasResponse` message with the following fields:
+
+| Name | Type | Repeated | Description |
+| --- | --- | --- | --- |
+| `success` | `boolean` | no | — |
+| `message` | `string` | no | — |
+| `wireObjectId` | `bigint` | no | 0 = no new stub |
+| `netAliasObjectId` | `bigint` | no | — |
+| `aliasPos` | `Vector2i64` | no | external display, Y down |
+| `stubLengthUsed` | `bigint` | no | actual stub length (ext) |
+| `usedExistingWire` | `boolean` | no | — |
+
+## Response Example
+
+Representative response structure (field values are placeholders):
+
+```json
+{
+  "success": false,
+  "message": "example",
+  "wireObjectId": "123456789",
+  "netAliasObjectId": "123456789",
+  "aliasPos": {},
+  "stubLengthUsed": "0",
+  "usedExistingWire": false
+}
+```
+
+## Prerequisites
+
+- [project-get-active-project](../../project/get-active-project/SKILL.md) — Discover the active project before building project-scoped context.
+
+See also [skill-dependencies.md](../../references/skill-dependencies.md) for common workflows.
+
+## How to Use
+
+Execute via the HQ EDA skill runtime with a connected `EditorClient`. See [quickstart.md](../../references/quickstart.md) for the full `listEditors` → `connect` → `getSkill` → `execute` chain.
+
+```typescript
+import { getSkill, toJsonString } from "@huaqiu/hqeda";
+
+const skill = getSkill("obj-place-place-pin-stub-wire-and-net-alias");
+const result = await skill.execute({ client }, {
+  context: "<ProjectContext via client.createProjectContext('my-project')>",
+  objectId: "123456789",
+  pinNum: 0,
+});
+console.log(toJsonString(result, { prettySpaces: 2 }));
+```
+
+Serialize responses with `toJsonString()` — see [serialization.md](../../references/serialization.md).
+
+## Related Skills
+
+- Other **obj-place** skills: [`obj-place/`](../)
+- Full index: [All EDA skills](../../SKILL.md)
+- Install: `npx skills add Huaqiu-Electronics/skills --path eda/obj-place/place-pin-stub-wire-and-net-alias`
+

package/skills/hqsch-scenario-b/docs/rpc/pattern-layout-apply-circuit-pattern.md

@@ -0,0 +1,125 @@
+---
+name: pattern-layout-apply-circuit-pattern
+metadata:
+  category: pattern-layout
+  service: PatternLayoutService
+  method: ApplyCircuitPattern
+  rpcKind: unary
+description: >-
+  Lay out and wire one circuit pattern. plan_only = true is the dry-run.
+version: 0.1.0
+vendor: Huaqiu Electronics
+tags:
+  - eda
+  - huaqiu
+  - pattern-layout
+entry: "@huaqiu/hqeda"
+manifest: "@huaqiu/hqeda/skill.json"
+inputSchema:
+  name: ApplyCircuitPatternRequestSchema
+  namespace: HqServicesV1PatternLayoutService
+---
+
+# Apply Circuit Pattern
+
+Lay out and wire one circuit pattern. plan_only = true is the dry-run.
+
+## Overview
+
+This skill provides access to the **`PatternLayoutService.ApplyCircuitPattern`** RPC method on the Huaqiu EDA engine. It is part of the **pattern-layout** domain and executes against the `patternLayout` client.
+
+| Property | Value |
+| --- | --- |
+| Skill ID | `pattern-layout-apply-circuit-pattern` |
+| Service | `PatternLayoutService` |
+| Method | `ApplyCircuitPattern` |
+| Transport | Unary (unary) |
+| Domain | pattern-layout |
+| Request type | `ApplyCircuitPatternRequest` |
+| Response type | `ApplyCircuitPatternResponse` |
+
+## Parameters
+
+| Name | Type | Required | Repeated | Description |
+| --- | --- | --- | --- | --- |
+| `context` | `ProjectContext` | no | no | — |
+| `pattern` | `CircuitPatternId` | yes | no | — |
+| `roles` | `PatternRoleBinding[]` | no | yes | — |
+| `anchor` | `Vector2i64` | no | no | External display coordinate; the exact meaning per pattern is documented in
+CircuitPatternDescriptor.anchor_semantics. |
+| `orientation` | `PatternOrientation` | yes | no | — |
+| `routeMode` | `PatternRouteMode` | yes | no | — |
+| `powerMode` | `PatternPowerMode` | yes | no | — |
+| `options` | `{ [key: string]: string }` | yes | no | Pattern-specific knobs; legal keys come from CircuitPatternDescriptor.options. |
+| `planOnly` | `boolean` | yes | no | Dry-run: compute the plan and the conflicts, touch nothing. |
+| `ignoreAreaConflict` | `boolean` | yes | no | — |
+
+## Response
+
+Returns a `ApplyCircuitPatternResponse` message with the following fields:
+
+| Name | Type | Repeated | Description |
+| --- | --- | --- | --- |
+| `status` | `PatternStatus` | no | — |
+| `message` | `string` | no | — |
+| `placements` | `PatternObjectPlacement[]` | yes | — |
+| `connections` | `PatternConnectionResult[]` | yes | — |
+| `createdObjectIds` | `bigint[]` | yes | Newly created wires / power symbols / net aliases. |
+| `occupiedBox` | `Box2i64` | no | Final footprint including wires and power symbols (external coordinates).
+Callers should book-keep this and avoid the area for later placements. |
+| `conflictingObjectIds` | `bigint[]` | yes | Objects intersecting occupied_box; use them to pick another anchor. |
+
+## Response Example
+
+Representative response structure (field values are placeholders):
+
+```json
+{
+  "status": {},
+  "message": "example",
+  "placements": [
+    {}
+  ],
+  "connections": [
+    {}
+  ],
+  "createdObjectIds": [
+    "123456789"
+  ],
+  "occupiedBox": {},
+  "conflictingObjectIds": [
+    "123456789"
+  ]
+}
+```
+
+## Prerequisites
+
+- [project-get-active-project](../../project/get-active-project/SKILL.md) — Discover the active project before building project-scoped context.
+
+See also [skill-dependencies.md](../../references/skill-dependencies.md) for common workflows.
+
+## How to Use
+
+Execute via the HQ EDA skill runtime with a connected `EditorClient`. See [quickstart.md](../../references/quickstart.md) for the full `listEditors` → `connect` → `getSkill` → `execute` chain.
+
+```typescript
+import { getSkill, toJsonString } from "@huaqiu/hqeda";
+
+const skill = getSkill("pattern-layout-apply-circuit-pattern");
+const result = await skill.execute({ client }, {
+  context: "<ProjectContext via client.createProjectContext('my-project')>",
+  pattern: {},
+  roles: [{}],
+});
+console.log(toJsonString(result, { prettySpaces: 2 }));
+```
+
+Serialize responses with `toJsonString()` — see [serialization.md](../../references/serialization.md).
+
+## Related Skills
+
+- Other **pattern-layout** skills: [`pattern-layout/`](../)
+- Full index: [All EDA skills](../../SKILL.md)
+- Install: `npx skills add Huaqiu-Electronics/skills --path eda/pattern-layout/apply-circuit-pattern`
+