create-zudo-circuit-doc 0.1.0

package/templates/default/circuit/generated/preflight.json

@@ -0,0 +1,625 @@
+{
+  "viewModelVersion": 2,
+  "provider": {
+    "id": "circuit-component-spec",
+    "contractVersion": 1
+  },
+  "records": {
+    "available": 0,
+    "selected": 0,
+    "slugs": []
+  },
+  "sources": {
+    "available": 0,
+    "selected": 0,
+    "linkable": 0,
+    "ids": []
+  },
+  "fields": [
+    {
+      "key": "record.recordId",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "record.slug",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "record.kind",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "record.parentRecordId",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "record.lineId",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "record.ownerSkill",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "record.mpn",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "record.manufacturer",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "record.lcsc",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "record.package",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "record.function",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "record.identityState",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "record.sourceState",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "record.dnp",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "record.placements",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "alias.mpn",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "alias.lcsc",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "alias.manufacturer",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "alias.function",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "routing.positivePrompts",
+      "decision": "DENY",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "routing.negativePrompts",
+      "decision": "DENY",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.sourceId",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.documentTitle",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.documentNumber",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.revision",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.documentDate",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.retrievalDate",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.authorityClass",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.availability",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.locator",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.printedPageLabel",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.physicalPdfPageIndex",
+      "decision": "DENY",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.authoritativeUrl",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.alternateAuthoritativeUrl",
+      "decision": "DENY",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.sha256",
+      "decision": "DENY",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "source.evidenceExtract",
+      "decision": "DENY",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "fact.factId",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "fact.class",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "fact.value",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "fact.unit",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "fact.conditions",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "fact.locator",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "fact.provenance",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "fact.verdict",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "fact.dependsOn",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "fact.expression",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "coverage.coverageId",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "coverage.domain",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "coverage.status",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "coverage.reason",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "coverage.factIds",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "coverage.blockingFactIds",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "interaction.interactionId",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "interaction.recordIds",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "interaction.factIds",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "interaction.conditions",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "interaction.verdict",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.ruleId",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.ownerSkill",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.domain",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.recordIds",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.factIds",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.conditions",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.verdict",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.refusal",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.calculationId",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.calculationFactIds",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.calculationExpression",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.calculationResultKey",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.calculationResults",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.calculationConditions",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.evidenceChainStage",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.evidenceChainStatus",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "integration.evidenceChainFactIds",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "pinMap.pinMapId",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "pinMap.symbol",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "pinMap.footprint",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "pinMap.pins",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "pinMap.reviewedBy",
+      "decision": "DENY",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.document.sourceId",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.document.documentTitle",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.document.label",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.document.authorityClass",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.document.url",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.document.availability",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.document.documentKind",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.footprint.packageId",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.footprint.name",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.footprint.path",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.model.path",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.model.offset",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.model.rotation",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.model.scale",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "reference.package.recordIds",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "corpus.counts",
+      "decision": "PUBLISH",
+      "emitted": 1,
+      "withheld": 0
+    },
+    {
+      "key": "asset.datasheetPdf",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "asset.footprintPreview",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "asset.modelPreview",
+      "decision": "PUBLISH",
+      "emitted": 0,
+      "withheld": 0
+    },
+    {
+      "key": "asset.binary",
+      "decision": "DENY",
+      "emitted": 0,
+      "withheld": 0
+    }
+  ],
+  "urls": [],
+  "counts": {
+    "generatedPages": 4,
+    "publishedCoverageDomains": 0,
+    "publishedFacts": 0,
+    "publishedIntegrationRules": 0,
+    "publishedInteractions": 0,
+    "publishedPinMaps": 0,
+    "publishedRecords": 0,
+    "publishedSources": 0
+  }
+}

package/templates/default/circuit/publication/assets.json

@@ -0,0 +1,9 @@
+{
+  "schema_version": 1,
+  "assets": [
+    {
+      "path": "favicon.svg",
+      "reason": "Site favicon shipped by the zudo-doc scaffold; not component evidence or CAD."
+    }
+  ]
+}

package/templates/default/circuit/publication/selection.json

@@ -0,0 +1,13 @@
+{
+  "schema_version": 1,
+  "recordIds": [],
+  "sourceIds": [],
+  "linkableSourceIds": [],
+  "documentSelections": [],
+  "expect": {
+    "records": 0,
+    "sources": 0,
+    "integrationRules": 0,
+    "packages": 0
+  }
+}

package/templates/default/circuit/templates/README.md

@@ -0,0 +1,33 @@
+# Authoring templates
+
+These templates are **not published**. Copy one into the documentation tree when the activity it describes actually happens; do not publish empty copies to fill the navigation.
+
+## Project documentation templates
+
+The `project-docs/` tree mirrors the site's sections. To use a template, copy it to the same relative path under `doc/src/content/docs/`, give the copy a topic-specific filename, `title`, `description` and `sidebar_position`, and replace the "Not entered" prompts as facts become known. Links inside a template point at the sibling template locations; after copying, keep a link only if its target page exists in the site.
+
+| Template | Use it when | What to enter |
+| --- | --- | --- |
+| [project/index.mdx](./project-docs/project/index.mdx) | The brief must be rebuilt from scratch (the live brief is already published at `project/index.mdx`) | Purpose, user behavior, constraints, current design revision |
+| [project/next-actions.mdx](./project-docs/project/next-actions.mdx) | Resetting the handoff page (the live page is already published) | Current open questions, the next bounded task, blocked work |
+| [project/task-request.mdx](./project-docs/project/task-request.mdx) | Delegating a bounded research or implementation task to an agent | Goal, scope, references, outputs and a definition of done |
+| [project/change-impact.mdx](./project-docs/project/change-impact.mdx) | Before applying a change with downstream effects (Workflow G) | Affected components, interfaces, generated assets and tests |
+| [architecture/overview.mdx](./project-docs/architecture/overview.mdx) | Resetting the architecture overview (the live page is already published) | Functional blocks, operating states, unconfirmed boundaries |
+| [architecture/interfaces.mdx](./project-docs/architecture/interfaces.mdx) | Once blocks or connectors are proposed | Power, signal, mechanical and programming boundaries |
+| [research/component-candidate.mdx](./project-docs/research/component-candidate.mdx) | Comparing or researching a component (Workflow A) | Research question, criteria, linked evidence, missing proof |
+| [decisions/decision.mdx](./project-docs/decisions/decision.mdx) | Making a consequential choice | Alternatives, chosen direction, tradeoffs, evidence and conditions |
+| [decisions/sourcing.mdx](./project-docs/decisions/sourcing.mdx) | Assembly or procurement becomes relevant | Population policy, cost reasoning, dated sourcing observations |
+| [verification/bring-up.mdx](./project-docs/verification/bring-up.mdx) | Planning or recording one verification run (Workflow F) | Revision, setup, planned checks, results and limits |
+
+For repeated records, duplicate the relevant template with a topic-specific filename. A decision ID identifies a decision across edits; a verification report identifies one execution against one revision, so never overwrite a failed run with a later successful one.
+
+These pages explain intent, rationale and decisions. Exact component identity, sources, facts, pin maps and coverage belong to the owner evidence bundles under `.claude/skills/component-*/`; the component pages under `/docs/components/` are generated from them. Do not maintain a second rating table, pin table or catalog by hand. When an argument needs a number, cite the canonical fact ID and keep its qualifier and conditions.
+
+## CAD asset receipt
+
+| Template | Use it when |
+| --- | --- |
+| [cad-asset-receipt.json](./cad-asset-receipt.json) | Recording an acquired symbol, footprint or 3D model (Workflow D); save the copy as `circuit/cad-receipts/ASSET_ID.receipt.json` |
+| [cad-asset-receipt.md](./cad-asset-receipt.md) | Explains every receipt field and the fidelity classes; copy it beside the JSON only when a longer explanation is needed |
+
+See [WORKFLOW.md](../WORKFLOW.md) for the workflows that use each template and [agent-task-examples.md](../agent-task-examples.md) for short requests that lead to them.