@tecture/shared 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @tecture/shared
+
+## 0.1.0
+
+- First public release. Exposes the Tecture API/data types (`ApiArchitectureSummary`,
+  `ApiDiagram`, `ApiNodeDetail`, `DiagramLayoutFile`, `ManifestFile`, …) plus the runtime
+  helpers (`buildArchitectureSummary`, `findNode`, `emptyLayout`, `normalizeLayoutUpdate`,
+  `buildSourceUrl`) and the `ArchitectureDataSource` / `LayoutStore` interfaces, so external
+  hosts can implement the Tecture data contract over any transport.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shanika Wijerathna
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,218 @@
+declare const SLUG_RE: RegExp;
+declare class DiagramNotFoundError extends Error {
+    readonly slug: string;
+    constructor(slug: string);
+}
+declare class NodeNotFoundError extends Error {
+    readonly id: string;
+    constructor(id: string);
+}
+declare class DescriptionNotFoundError extends Error {
+    readonly id: string;
+    constructor(id: string);
+}
+declare class LayoutInvalidError extends Error {
+    constructor(message: string);
+}
+interface ArchitectureDataSource {
+    loadManifest(): Promise<ManifestFile>;
+    loadDiagram(slug: string): Promise<DiagramFile>;
+    loadDescription(nodeId: string): Promise<string>;
+}
+interface LayoutStore {
+    loadLayout(slug: string): Promise<DiagramLayoutFile>;
+    saveLayout(slug: string, update: ApiDiagramLayoutUpdate): Promise<DiagramLayoutFile>;
+}
+declare function isFiniteNumber(v: unknown): v is number;
+declare function isValidLayoutEntry(v: unknown): v is NodeLayoutEntry;
+declare function emptyLayout(slug: string): DiagramLayoutFile;
+declare function normalizeLayoutUpdate(slug: string, update: ApiDiagramLayoutUpdate): DiagramLayoutFile;
+declare function buildArchitectureSummary(source: ArchitectureDataSource): Promise<ApiArchitectureSummary>;
+/**
+ * Build a web URL that views `path` (a repo-root-relative file or directory, trailing "/" = dir)
+ * on the source repo host. `HEAD` resolves to the default branch so links stay current. Falls back
+ * to the repo root when the host is unknown, and returns undefined when there is no source.
+ */
+declare function buildSourceUrl(source: string | undefined, host: SourceHost | undefined, path: string): string | undefined;
+declare function findNode(source: ArchitectureDataSource, nodeId: string): Promise<{
+    node: ArchitectureNode;
+    diagramId: string;
+}>;
+
+/**
+ * Whether a node is worth deep-diving — i.e. first-party code the team owns.
+ * True when the node carries a repo `path`, or its type is a code container
+ * (service / frontend / gateway). People, external SaaS, and managed infra
+ * (database / cache / queue / storage) have nothing in the repo to investigate.
+ */
+declare function isDeepDivable(node: Pick<ArchitectureNode, "path" | "meta">): boolean;
+/**
+ * Build the prompt a user copies into a coding agent to enrich one component's
+ * description. It invokes the skill's deep-dive via its slash command, keyed on
+ * the node `id` (unambiguous) — it deliberately does not restate how to deep-dive,
+ * since the architecture-docs skill already owns that (which files to read,
+ * dependencies to trace, the target description file, prose-only, etc.).
+ */
+declare function buildDeepDivePrompt(node: Pick<ArchitectureNode, "id">): string;
+
+interface ApiHealthResponse {
+    status: "ok";
+    uptime: number;
+    timestamp: string;
+}
+type DiagramDirection = "TB" | "LR";
+type DiagramLevel = 1 | 2 | 3;
+type SourceHost = "github" | "gitlab" | "bitbucket";
+type NodeMetaType = "system" | "person" | "service" | "database" | "queue" | "gateway" | "frontend" | "cache" | "storage" | "external";
+type EdgeMetaType = "calls" | "reads" | "writes" | "publishes" | "subscribes" | "data-flow";
+interface NodeMeta {
+    type?: NodeMetaType;
+    technology?: string;
+    isContainer?: boolean;
+    [key: string]: unknown;
+}
+interface EdgeMeta {
+    type?: EdgeMetaType;
+    [key: string]: unknown;
+}
+interface ArchitectureNode {
+    id: string;
+    label: string;
+    parentId?: string | null;
+    subDiagramId?: string | null;
+    /** Repo-root-relative path to the file or directory this node maps to. Trailing "/" = directory. */
+    path?: string;
+    meta?: NodeMeta;
+}
+interface ArchitectureEdge {
+    id: string;
+    source: string;
+    target: string;
+    label?: string;
+    meta?: EdgeMeta;
+}
+interface DiagramFile {
+    name: string;
+    level?: DiagramLevel;
+    meta?: {
+        direction?: DiagramDirection;
+        layout?: string;
+    };
+    nodes: ArchitectureNode[];
+    edges?: ArchitectureEdge[];
+}
+interface ManifestFile {
+    name: string;
+    description?: string;
+    source?: string;
+    sourceHost?: SourceHost;
+    topDiagram: string;
+    diagrams: string[];
+}
+interface ApiDiagramSummary {
+    slug: string;
+    name: string;
+    level?: DiagramLevel;
+    nodeCount: number;
+    edgeCount: number;
+}
+interface ApiArchitectureSummary {
+    name: string;
+    description?: string;
+    source?: string;
+    sourceHost?: SourceHost;
+    topDiagram: string;
+    diagrams: ApiDiagramSummary[];
+}
+interface ApiDiagram extends DiagramFile {
+    slug: string;
+    edges: ArchitectureEdge[];
+}
+interface ApiDiagramNodes {
+    diagramId: string;
+    nodes: ArchitectureNode[];
+}
+interface ApiDiagramEdges {
+    diagramId: string;
+    edges: ArchitectureEdge[];
+}
+interface ApiNodeDetail extends ArchitectureNode {
+    diagramId: string;
+    description: string;
+}
+interface NodeLayoutEntry {
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+}
+interface DiagramLayoutFile {
+    version: 1;
+    diagramId: string;
+    updatedAt: string;
+    nodes: Record<string, NodeLayoutEntry>;
+}
+interface ApiDiagramLayout extends DiagramLayoutFile {
+}
+interface ApiDiagramLayoutUpdate {
+    nodes: Record<string, NodeLayoutEntry>;
+}
+type ApiArchitectureErrorCode = "diagram_not_found" | "node_not_found" | "description_not_found" | "architecture_unreadable" | "layout_invalid" | "layout_not_supported";
+interface ApiArchitectureError {
+    error: ApiArchitectureErrorCode;
+    message?: string;
+    slug?: string;
+    id?: string;
+}
+type TectureRequest = {
+    id: string;
+    type: "loadSummary";
+} | {
+    id: string;
+    type: "loadDiagram";
+    slug: string;
+} | {
+    id: string;
+    type: "loadLayout";
+    slug: string;
+} | {
+    id: string;
+    type: "loadNodeDetail";
+    nodeId: string;
+} | {
+    id: string;
+    type: "openFile";
+    path: string;
+} | {
+    id: string;
+    type: "saveLayout";
+    slug: string;
+    update: ApiDiagramLayoutUpdate;
+};
+type TectureResponse = {
+    id: string;
+    ok: true;
+    data: unknown;
+} | {
+    id: string;
+    ok: false;
+    error: string;
+};
+type TectureEvent = {
+    type: "refresh";
+} | {
+    type: "selectDiagram";
+    slug: string;
+};
+type TectureNotification = {
+    type: "ready";
+} | {
+    type: "diagramChanged";
+    slug: string;
+} | {
+    type: "usage";
+    event: string;
+    level?: number;
+};
+
+export { type ApiArchitectureError, type ApiArchitectureErrorCode, type ApiArchitectureSummary, type ApiDiagram, type ApiDiagramEdges, type ApiDiagramLayout, type ApiDiagramLayoutUpdate, type ApiDiagramNodes, type ApiDiagramSummary, type ApiHealthResponse, type ApiNodeDetail, type ArchitectureDataSource, type ArchitectureEdge, type ArchitectureNode, DescriptionNotFoundError, type DiagramDirection, type DiagramFile, type DiagramLayoutFile, type DiagramLevel, DiagramNotFoundError, type EdgeMeta, type EdgeMetaType, LayoutInvalidError, type LayoutStore, type ManifestFile, type NodeLayoutEntry, type NodeMeta, type NodeMetaType, NodeNotFoundError, SLUG_RE, type SourceHost, type TectureEvent, type TectureNotification, type TectureRequest, type TectureResponse, buildArchitectureSummary, buildDeepDivePrompt, buildSourceUrl, emptyLayout, findNode, isDeepDivable, isFiniteNumber, isValidLayoutEntry, normalizeLayoutUpdate };

package/dist/index.js

@@ -0,0 +1,174 @@
+// src/validators.ts
+var SLUG_RE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+var DiagramNotFoundError = class extends Error {
+  constructor(slug) {
+    super(`Diagram not found: ${slug}`);
+    this.slug = slug;
+    this.name = "DiagramNotFoundError";
+  }
+  slug;
+};
+var NodeNotFoundError = class extends Error {
+  constructor(id) {
+    super(`Node not found: ${id}`);
+    this.id = id;
+    this.name = "NodeNotFoundError";
+  }
+  id;
+};
+var DescriptionNotFoundError = class extends Error {
+  constructor(id) {
+    super(`Description not found: ${id}`);
+    this.id = id;
+    this.name = "DescriptionNotFoundError";
+  }
+  id;
+};
+var LayoutInvalidError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "LayoutInvalidError";
+  }
+};
+function isFiniteNumber(v) {
+  return typeof v === "number" && Number.isFinite(v);
+}
+function isValidLayoutEntry(v) {
+  if (!v || typeof v !== "object") return false;
+  const e = v;
+  if (!isFiniteNumber(e.x) || !isFiniteNumber(e.y)) return false;
+  if ("width" in e && e.width !== void 0 && !isFiniteNumber(e.width)) return false;
+  if ("height" in e && e.height !== void 0 && !isFiniteNumber(e.height)) return false;
+  return true;
+}
+function emptyLayout(slug) {
+  return { version: 1, diagramId: slug, updatedAt: "", nodes: {} };
+}
+function normalizeLayoutUpdate(slug, update) {
+  if (!SLUG_RE.test(slug)) {
+    throw new LayoutInvalidError(`invalid diagram slug: ${slug}`);
+  }
+  if (!update || typeof update !== "object" || !update.nodes || typeof update.nodes !== "object") {
+    throw new LayoutInvalidError(
+      "body must be { nodes: Record<string, { x, y, width?, height? }> }"
+    );
+  }
+  const nodes = {};
+  for (const [id, entry] of Object.entries(update.nodes)) {
+    if (!SLUG_RE.test(id)) {
+      throw new LayoutInvalidError(`invalid node id: ${id}`);
+    }
+    if (!isValidLayoutEntry(entry)) {
+      throw new LayoutInvalidError(`invalid layout entry for ${id}`);
+    }
+    const out = { x: entry.x, y: entry.y };
+    if (isFiniteNumber(entry.width)) out.width = entry.width;
+    if (isFiniteNumber(entry.height)) out.height = entry.height;
+    nodes[id] = out;
+  }
+  return {
+    version: 1,
+    diagramId: slug,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    nodes
+  };
+}
+async function buildArchitectureSummary(source) {
+  const manifest = await source.loadManifest();
+  const diagrams = await Promise.all(
+    manifest.diagrams.map(async (slug) => {
+      const diagram = await source.loadDiagram(slug);
+      return {
+        slug,
+        name: diagram.name,
+        level: diagram.level,
+        nodeCount: diagram.nodes?.length ?? 0,
+        edgeCount: diagram.edges?.length ?? 0
+      };
+    })
+  );
+  return {
+    name: manifest.name,
+    description: manifest.description,
+    source: manifest.source,
+    sourceHost: manifest.sourceHost,
+    topDiagram: manifest.topDiagram,
+    diagrams
+  };
+}
+var HOST_DOMAINS = [
+  { host: "github", match: /(^|\.)github\.com$/i },
+  { host: "gitlab", match: /(^|\.)gitlab\.com$/i },
+  { host: "bitbucket", match: /(^|\.)bitbucket\.org$/i }
+];
+function inferSourceHost(source) {
+  const hostname = /^[a-z][a-z0-9+.-]*:\/\/(?:[^@/]*@)?([^:/?#]+)/i.exec(source)?.[1];
+  if (!hostname) return void 0;
+  return HOST_DOMAINS.find(({ match }) => match.test(hostname))?.host;
+}
+function buildSourceUrl(source, host, path) {
+  if (!source) return void 0;
+  const base = source.replace(/\/+$/, "").replace(/\.git$/i, "");
+  const resolvedHost = host ?? inferSourceHost(base);
+  const isDir = path.endsWith("/");
+  const encoded = path.replace(/^\/+/, "").replace(/\/+$/, "").split("/").map(encodeURIComponent).join("/");
+  if (!encoded) return base;
+  switch (resolvedHost) {
+    case "github":
+      return `${base}/${isDir ? "tree" : "blob"}/HEAD/${encoded}`;
+    case "gitlab":
+      return `${base}/-/${isDir ? "tree" : "blob"}/HEAD/${encoded}`;
+    case "bitbucket":
+      return `${base}/src/HEAD/${encoded}`;
+    default:
+      return base;
+  }
+}
+async function findNode(source, nodeId) {
+  if (!SLUG_RE.test(nodeId)) throw new NodeNotFoundError(nodeId);
+  const manifest = await source.loadManifest();
+  for (const slug of manifest.diagrams) {
+    let diagram;
+    try {
+      diagram = await source.loadDiagram(slug);
+    } catch (err) {
+      if (err instanceof DiagramNotFoundError) continue;
+      throw err;
+    }
+    const match = diagram.nodes?.find((n) => n.id === nodeId);
+    if (match) return { node: match, diagramId: slug };
+  }
+  throw new NodeNotFoundError(nodeId);
+}
+
+// src/deepDive.ts
+var CODE_NODE_TYPES = /* @__PURE__ */ new Set([
+  "service",
+  "frontend",
+  "gateway"
+]);
+function isDeepDivable(node) {
+  if (node.path) return true;
+  const type = node.meta?.type;
+  return type !== void 0 && CODE_NODE_TYPES.has(type);
+}
+function buildDeepDivePrompt(node) {
+  return `/architecture-docs deep-dive ${node.id}`;
+}
+export {
+  DescriptionNotFoundError,
+  DiagramNotFoundError,
+  LayoutInvalidError,
+  NodeNotFoundError,
+  SLUG_RE,
+  buildArchitectureSummary,
+  buildDeepDivePrompt,
+  buildSourceUrl,
+  emptyLayout,
+  findNode,
+  isDeepDivable,
+  isFiniteNumber,
+  isValidLayoutEntry,
+  normalizeLayoutUpdate
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/validators.ts","../src/deepDive.ts"],"sourcesContent":["import type {\n  ApiArchitectureSummary,\n  ApiDiagramLayoutUpdate,\n  ApiDiagramSummary,\n  ArchitectureNode,\n  DiagramFile,\n  DiagramLayoutFile,\n  ManifestFile,\n  NodeLayoutEntry,\n  SourceHost,\n} from \"./index\";\n\nexport const SLUG_RE = /^[a-z0-9]+(-[a-z0-9]+)*$/;\n\nexport class DiagramNotFoundError extends Error {\n  constructor(public readonly slug: string) {\n    super(`Diagram not found: ${slug}`);\n    this.name = \"DiagramNotFoundError\";\n  }\n}\n\nexport class NodeNotFoundError extends Error {\n  constructor(public readonly id: string) {\n    super(`Node not found: ${id}`);\n    this.name = \"NodeNotFoundError\";\n  }\n}\n\nexport class DescriptionNotFoundError extends Error {\n  constructor(public readonly id: string) {\n    super(`Description not found: ${id}`);\n    this.name = \"DescriptionNotFoundError\";\n  }\n}\n\nexport class LayoutInvalidError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"LayoutInvalidError\";\n  }\n}\n\nexport interface ArchitectureDataSource {\n  loadManifest(): Promise<ManifestFile>;\n  loadDiagram(slug: string): Promise<DiagramFile>;\n  loadDescription(nodeId: string): Promise<string>;\n}\n\nexport interface LayoutStore {\n  loadLayout(slug: string): Promise<DiagramLayoutFile>;\n  saveLayout(\n    slug: string,\n    update: ApiDiagramLayoutUpdate,\n  ): Promise<DiagramLayoutFile>;\n}\n\nexport function isFiniteNumber(v: unknown): v is number {\n  return typeof v === \"number\" && Number.isFinite(v);\n}\n\nexport function isValidLayoutEntry(v: unknown): v is NodeLayoutEntry {\n  if (!v || typeof v !== \"object\") return false;\n  const e = v as Record<string, unknown>;\n  if (!isFiniteNumber(e.x) || !isFiniteNumber(e.y)) return false;\n  if (\"width\" in e && e.width !== undefined && !isFiniteNumber(e.width)) return false;\n  if (\"height\" in e && e.height !== undefined && !isFiniteNumber(e.height)) return false;\n  return true;\n}\n\nexport function emptyLayout(slug: string): DiagramLayoutFile {\n  return { version: 1, diagramId: slug, updatedAt: \"\", nodes: {} };\n}\n\nexport function normalizeLayoutUpdate(\n  slug: string,\n  update: ApiDiagramLayoutUpdate,\n): DiagramLayoutFile {\n  if (!SLUG_RE.test(slug)) {\n    throw new LayoutInvalidError(`invalid diagram slug: ${slug}`);\n  }\n  if (\n    !update ||\n    typeof update !== \"object\" ||\n    !update.nodes ||\n    typeof update.nodes !== \"object\"\n  ) {\n    throw new LayoutInvalidError(\n      \"body must be { nodes: Record<string, { x, y, width?, height? }> }\",\n    );\n  }\n  const nodes: Record<string, NodeLayoutEntry> = {};\n  for (const [id, entry] of Object.entries(update.nodes)) {\n    if (!SLUG_RE.test(id)) {\n      throw new LayoutInvalidError(`invalid node id: ${id}`);\n    }\n    if (!isValidLayoutEntry(entry)) {\n      throw new LayoutInvalidError(`invalid layout entry for ${id}`);\n    }\n    const out: NodeLayoutEntry = { x: entry.x, y: entry.y };\n    if (isFiniteNumber(entry.width)) out.width = entry.width;\n    if (isFiniteNumber(entry.height)) out.height = entry.height;\n    nodes[id] = out;\n  }\n  return {\n    version: 1,\n    diagramId: slug,\n    updatedAt: new Date().toISOString(),\n    nodes,\n  };\n}\n\nexport async function buildArchitectureSummary(\n  source: ArchitectureDataSource,\n): Promise<ApiArchitectureSummary> {\n  const manifest = await source.loadManifest();\n  const diagrams = await Promise.all(\n    manifest.diagrams.map(async (slug): Promise<ApiDiagramSummary> => {\n      const diagram = await source.loadDiagram(slug);\n      return {\n        slug,\n        name: diagram.name,\n        level: diagram.level,\n        nodeCount: diagram.nodes?.length ?? 0,\n        edgeCount: diagram.edges?.length ?? 0,\n      };\n    }),\n  );\n  return {\n    name: manifest.name,\n    description: manifest.description,\n    source: manifest.source,\n    sourceHost: manifest.sourceHost,\n    topDiagram: manifest.topDiagram,\n    diagrams,\n  };\n}\n\nconst HOST_DOMAINS: Array<{ host: SourceHost; match: RegExp }> = [\n  { host: \"github\", match: /(^|\\.)github\\.com$/i },\n  { host: \"gitlab\", match: /(^|\\.)gitlab\\.com$/i },\n  { host: \"bitbucket\", match: /(^|\\.)bitbucket\\.org$/i },\n];\n\nfunction inferSourceHost(source: string): SourceHost | undefined {\n  // Extract the hostname without relying on the URL global (kept lib-agnostic for shared):\n  // scheme://[userinfo@]host[:port]/...\n  const hostname = /^[a-z][a-z0-9+.-]*:\\/\\/(?:[^@/]*@)?([^:/?#]+)/i.exec(source)?.[1];\n  if (!hostname) return undefined;\n  return HOST_DOMAINS.find(({ match }) => match.test(hostname))?.host;\n}\n\n/**\n * Build a web URL that views `path` (a repo-root-relative file or directory, trailing \"/\" = dir)\n * on the source repo host. `HEAD` resolves to the default branch so links stay current. Falls back\n * to the repo root when the host is unknown, and returns undefined when there is no source.\n */\nexport function buildSourceUrl(\n  source: string | undefined,\n  host: SourceHost | undefined,\n  path: string,\n): string | undefined {\n  if (!source) return undefined;\n  const base = source.replace(/\\/+$/, \"\").replace(/\\.git$/i, \"\");\n  const resolvedHost = host ?? inferSourceHost(base);\n  const isDir = path.endsWith(\"/\");\n  const encoded = path\n    .replace(/^\\/+/, \"\")\n    .replace(/\\/+$/, \"\")\n    .split(\"/\")\n    .map(encodeURIComponent)\n    .join(\"/\");\n  if (!encoded) return base;\n  switch (resolvedHost) {\n    case \"github\":\n      return `${base}/${isDir ? \"tree\" : \"blob\"}/HEAD/${encoded}`;\n    case \"gitlab\":\n      return `${base}/-/${isDir ? \"tree\" : \"blob\"}/HEAD/${encoded}`;\n    case \"bitbucket\":\n      return `${base}/src/HEAD/${encoded}`;\n    default:\n      return base;\n  }\n}\n\nexport async function findNode(\n  source: ArchitectureDataSource,\n  nodeId: string,\n): Promise<{ node: ArchitectureNode; diagramId: string }> {\n  if (!SLUG_RE.test(nodeId)) throw new NodeNotFoundError(nodeId);\n  const manifest = await source.loadManifest();\n  for (const slug of manifest.diagrams) {\n    let diagram: DiagramFile;\n    try {\n      diagram = await source.loadDiagram(slug);\n    } catch (err) {\n      if (err instanceof DiagramNotFoundError) continue;\n      throw err;\n    }\n    const match = diagram.nodes?.find((n) => n.id === nodeId);\n    if (match) return { node: match, diagramId: slug };\n  }\n  throw new NodeNotFoundError(nodeId);\n}\n","import type { ArchitectureNode, NodeMetaType } from \"./index\";\n\n/** Node types that map to first-party code worth a deep-dive. */\nconst CODE_NODE_TYPES: ReadonlySet<NodeMetaType> = new Set([\n  \"service\",\n  \"frontend\",\n  \"gateway\",\n]);\n\n/**\n * Whether a node is worth deep-diving — i.e. first-party code the team owns.\n * True when the node carries a repo `path`, or its type is a code container\n * (service / frontend / gateway). People, external SaaS, and managed infra\n * (database / cache / queue / storage) have nothing in the repo to investigate.\n */\nexport function isDeepDivable(\n  node: Pick<ArchitectureNode, \"path\" | \"meta\">,\n): boolean {\n  if (node.path) return true;\n  const type = node.meta?.type;\n  return type !== undefined && CODE_NODE_TYPES.has(type);\n}\n\n/**\n * Build the prompt a user copies into a coding agent to enrich one component's\n * description. It invokes the skill's deep-dive via its slash command, keyed on\n * the node `id` (unambiguous) — it deliberately does not restate how to deep-dive,\n * since the architecture-docs skill already owns that (which files to read,\n * dependencies to trace, the target description file, prose-only, etc.).\n */\nexport function buildDeepDivePrompt(\n  node: Pick<ArchitectureNode, \"id\">,\n): string {\n  return `/architecture-docs deep-dive ${node.id}`;\n}\n"],"mappings":";AAYO,IAAM,UAAU;AAEhB,IAAM,uBAAN,cAAmC,MAAM;AAAA,EAC9C,YAA4B,MAAc;AACxC,UAAM,sBAAsB,IAAI,EAAE;AADR;AAE1B,SAAK,OAAO;AAAA,EACd;AAAA,EAH4B;AAI9B;AAEO,IAAM,oBAAN,cAAgC,MAAM;AAAA,EAC3C,YAA4B,IAAY;AACtC,UAAM,mBAAmB,EAAE,EAAE;AADH;AAE1B,SAAK,OAAO;AAAA,EACd;AAAA,EAH4B;AAI9B;AAEO,IAAM,2BAAN,cAAuC,MAAM;AAAA,EAClD,YAA4B,IAAY;AACtC,UAAM,0BAA0B,EAAE,EAAE;AADV;AAE1B,SAAK,OAAO;AAAA,EACd;AAAA,EAH4B;AAI9B;AAEO,IAAM,qBAAN,cAAiC,MAAM;AAAA,EAC5C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAgBO,SAAS,eAAe,GAAyB;AACtD,SAAO,OAAO,MAAM,YAAY,OAAO,SAAS,CAAC;AACnD;AAEO,SAAS,mBAAmB,GAAkC;AACnE,MAAI,CAAC,KAAK,OAAO,MAAM,SAAU,QAAO;AACxC,QAAM,IAAI;AACV,MAAI,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,EAAG,QAAO;AACzD,MAAI,WAAW,KAAK,EAAE,UAAU,UAAa,CAAC,eAAe,EAAE,KAAK,EAAG,QAAO;AAC9E,MAAI,YAAY,KAAK,EAAE,WAAW,UAAa,CAAC,eAAe,EAAE,MAAM,EAAG,QAAO;AACjF,SAAO;AACT;AAEO,SAAS,YAAY,MAAiC;AAC3D,SAAO,EAAE,SAAS,GAAG,WAAW,MAAM,WAAW,IAAI,OAAO,CAAC,EAAE;AACjE;AAEO,SAAS,sBACd,MACA,QACmB;AACnB,MAAI,CAAC,QAAQ,KAAK,IAAI,GAAG;AACvB,UAAM,IAAI,mBAAmB,yBAAyB,IAAI,EAAE;AAAA,EAC9D;AACA,MACE,CAAC,UACD,OAAO,WAAW,YAClB,CAAC,OAAO,SACR,OAAO,OAAO,UAAU,UACxB;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,QAAM,QAAyC,CAAC;AAChD,aAAW,CAAC,IAAI,KAAK,KAAK,OAAO,QAAQ,OAAO,KAAK,GAAG;AACtD,QAAI,CAAC,QAAQ,KAAK,EAAE,GAAG;AACrB,YAAM,IAAI,mBAAmB,oBAAoB,EAAE,EAAE;AAAA,IACvD;AACA,QAAI,CAAC,mBAAmB,KAAK,GAAG;AAC9B,YAAM,IAAI,mBAAmB,4BAA4B,EAAE,EAAE;AAAA,IAC/D;AACA,UAAM,MAAuB,EAAE,GAAG,MAAM,GAAG,GAAG,MAAM,EAAE;AACtD,QAAI,eAAe,MAAM,KAAK,EAAG,KAAI,QAAQ,MAAM;AACnD,QAAI,eAAe,MAAM,MAAM,EAAG,KAAI,SAAS,MAAM;AACrD,UAAM,EAAE,IAAI;AAAA,EACd;AACA,SAAO;AAAA,IACL,SAAS;AAAA,IACT,WAAW;AAAA,IACX,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IAClC;AAAA,EACF;AACF;AAEA,eAAsB,yBACpB,QACiC;AACjC,QAAM,WAAW,MAAM,OAAO,aAAa;AAC3C,QAAM,WAAW,MAAM,QAAQ;AAAA,IAC7B,SAAS,SAAS,IAAI,OAAO,SAAqC;AAChE,YAAM,UAAU,MAAM,OAAO,YAAY,IAAI;AAC7C,aAAO;AAAA,QACL;AAAA,QACA,MAAM,QAAQ;AAAA,QACd,OAAO,QAAQ;AAAA,QACf,WAAW,QAAQ,OAAO,UAAU;AAAA,QACpC,WAAW,QAAQ,OAAO,UAAU;AAAA,MACtC;AAAA,IACF,CAAC;AAAA,EACH;AACA,SAAO;AAAA,IACL,MAAM,SAAS;AAAA,IACf,aAAa,SAAS;AAAA,IACtB,QAAQ,SAAS;AAAA,IACjB,YAAY,SAAS;AAAA,IACrB,YAAY,SAAS;AAAA,IACrB;AAAA,EACF;AACF;AAEA,IAAM,eAA2D;AAAA,EAC/D,EAAE,MAAM,UAAU,OAAO,sBAAsB;AAAA,EAC/C,EAAE,MAAM,UAAU,OAAO,sBAAsB;AAAA,EAC/C,EAAE,MAAM,aAAa,OAAO,yBAAyB;AACvD;AAEA,SAAS,gBAAgB,QAAwC;AAG/D,QAAM,WAAW,iDAAiD,KAAK,MAAM,IAAI,CAAC;AAClF,MAAI,CAAC,SAAU,QAAO;AACtB,SAAO,aAAa,KAAK,CAAC,EAAE,MAAM,MAAM,MAAM,KAAK,QAAQ,CAAC,GAAG;AACjE;AAOO,SAAS,eACd,QACA,MACA,MACoB;AACpB,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,OAAO,OAAO,QAAQ,QAAQ,EAAE,EAAE,QAAQ,WAAW,EAAE;AAC7D,QAAM,eAAe,QAAQ,gBAAgB,IAAI;AACjD,QAAM,QAAQ,KAAK,SAAS,GAAG;AAC/B,QAAM,UAAU,KACb,QAAQ,QAAQ,EAAE,EAClB,QAAQ,QAAQ,EAAE,EAClB,MAAM,GAAG,EACT,IAAI,kBAAkB,EACtB,KAAK,GAAG;AACX,MAAI,CAAC,QAAS,QAAO;AACrB,UAAQ,cAAc;AAAA,IACpB,KAAK;AACH,aAAO,GAAG,IAAI,IAAI,QAAQ,SAAS,MAAM,SAAS,OAAO;AAAA,IAC3D,KAAK;AACH,aAAO,GAAG,IAAI,MAAM,QAAQ,SAAS,MAAM,SAAS,OAAO;AAAA,IAC7D,KAAK;AACH,aAAO,GAAG,IAAI,aAAa,OAAO;AAAA,IACpC;AACE,aAAO;AAAA,EACX;AACF;AAEA,eAAsB,SACpB,QACA,QACwD;AACxD,MAAI,CAAC,QAAQ,KAAK,MAAM,EAAG,OAAM,IAAI,kBAAkB,MAAM;AAC7D,QAAM,WAAW,MAAM,OAAO,aAAa;AAC3C,aAAW,QAAQ,SAAS,UAAU;AACpC,QAAI;AACJ,QAAI;AACF,gBAAU,MAAM,OAAO,YAAY,IAAI;AAAA,IACzC,SAAS,KAAK;AACZ,UAAI,eAAe,qBAAsB;AACzC,YAAM;AAAA,IACR;AACA,UAAM,QAAQ,QAAQ,OAAO,KAAK,CAAC,MAAM,EAAE,OAAO,MAAM;AACxD,QAAI,MAAO,QAAO,EAAE,MAAM,OAAO,WAAW,KAAK;AAAA,EACnD;AACA,QAAM,IAAI,kBAAkB,MAAM;AACpC;;;ACvMA,IAAM,kBAA6C,oBAAI,IAAI;AAAA,EACzD;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAQM,SAAS,cACd,MACS;AACT,MAAI,KAAK,KAAM,QAAO;AACtB,QAAM,OAAO,KAAK,MAAM;AACxB,SAAO,SAAS,UAAa,gBAAgB,IAAI,IAAI;AACvD;AASO,SAAS,oBACd,MACQ;AACR,SAAO,gCAAgC,KAAK,EAAE;AAChD;","names":[]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@tecture/shared",
+  "version": "0.1.0",
+  "description": "Shared types and runtime helpers for Tecture — the file-based (JSON + Markdown) architecture documentation format.",
+  "keywords": [
+    "c4",
+    "architecture",
+    "diagram",
+    "documentation",
+    "tecture"
+  ],
+  "license": "MIT",
+  "author": "Shanika Wijerathna <shanikacj@gmail.com>",
+  "homepage": "https://github.com/tecture-io/tecture#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tecture-io/tecture.git",
+    "directory": "packages/shared"
+  },
+  "bugs": {
+    "url": "https://github.com/tecture-io/tecture/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}