From 043818072c363ef550a1d285701a19c2c415469e Mon Sep 17 00:00:00 2001 From: Dylan McCurry Date: Wed, 30 Sep 2026 17:33:56 -0400 Subject: [PATCH 1/7] chore: preserve blocked Rust/Tauri integration Partial implementation only; not a delivery-ready candidate. Graphviz 16.0.0 embeds EPL-2.0 code, which conflicts with the current exact license policy. Stop pending parent authorization of a narrow exception or approved alternative. Typecheck and workspace rollback tests pass. Story schema strictRequired tests and composed graph module-version validation still fail. Full browser, package, license and integration gates remain incomplete. --- licenses/third-party/ast-grep.LICENSE | 21 + licenses/third-party/expat.COPYING | 21 + licenses/third-party/graphviz.COPYING | 277 ++++++ licenses/third-party/viz-js.LICENSE | 21 + packages/cli/package.json | 1 + packages/cli/src/catalogue.ts | 102 ++- packages/cli/src/main.ts | 6 +- packages/cli/src/pipeline.ts | 27 +- packages/cli/src/repository-index.ts | 31 + packages/cli/tsconfig.json | 1 + packages/diagram-core/package.json | 3 +- packages/diagram-core/src/graphviz.ts | 82 ++ packages/diagram-core/src/index.ts | 32 +- packages/diagram-core/src/theme.ts | 60 ++ packages/languages/package.json | 31 + packages/languages/src/contract-types.ts | 85 ++ packages/languages/src/contract.mjs | 69 ++ packages/languages/src/index.ts | 290 ++++++ packages/languages/src/inventory.mjs | 102 +++ packages/languages/src/plugins/rust.mjs | 881 +++++++++++++++++++ packages/languages/src/plugins/tauri.mjs | 372 ++++++++ packages/languages/test/composition.test.mjs | 43 + packages/languages/test/helpers.mjs | 38 + packages/languages/test/rust.test.mjs | 560 ++++++++++++ packages/languages/test/tauri.test.mjs | 224 +++++ packages/languages/tsconfig.json | 13 + packages/scanner/package.json | 2 +- packages/scanner/src/types.ts | 16 +- packages/scanner/src/typescript-scanner.ts | 2 +- packages/site/package.json | 1 + packages/story/package.json | 3 +- packages/story/src/index.ts | 56 +- packages/story/src/technical.test.ts | 29 + packages/story/story.schema.json | 36 +- packages/story/tsconfig.json | 1 + packages/workspace/src/index.ts | 133 ++- packages/workspace/src/publication.test.ts | 43 + scripts/pack.mjs | 8 +- scripts/package-smoke.mjs | 2 +- yarn.lock | 166 +++- 40 files changed, 3809 insertions(+), 82 deletions(-) create mode 100644 licenses/third-party/ast-grep.LICENSE create mode 100644 licenses/third-party/expat.COPYING create mode 100644 licenses/third-party/graphviz.COPYING create mode 100644 licenses/third-party/viz-js.LICENSE create mode 100644 packages/diagram-core/src/graphviz.ts create mode 100644 packages/diagram-core/src/theme.ts create mode 100644 packages/languages/package.json create mode 100644 packages/languages/src/contract-types.ts create mode 100644 packages/languages/src/contract.mjs create mode 100644 packages/languages/src/index.ts create mode 100644 packages/languages/src/inventory.mjs create mode 100644 packages/languages/src/plugins/rust.mjs create mode 100644 packages/languages/src/plugins/tauri.mjs create mode 100644 packages/languages/test/composition.test.mjs create mode 100644 packages/languages/test/helpers.mjs create mode 100644 packages/languages/test/rust.test.mjs create mode 100644 packages/languages/test/tauri.test.mjs create mode 100644 packages/languages/tsconfig.json create mode 100644 packages/story/src/technical.test.ts create mode 100644 packages/workspace/src/publication.test.ts diff --git a/licenses/third-party/ast-grep.LICENSE b/licenses/third-party/ast-grep.LICENSE new file mode 100644 index 0000000..f15282f --- /dev/null +++ b/licenses/third-party/ast-grep.LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2022 Herrington Darkholme + +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. diff --git a/licenses/third-party/expat.COPYING b/licenses/third-party/expat.COPYING new file mode 100644 index 0000000..1fe8abb --- /dev/null +++ b/licenses/third-party/expat.COPYING @@ -0,0 +1,21 @@ +Copyright (c) 1998-2000 Thai Open Source Software Center Ltd and Clark Cooper +Copyright (c) 2001-2026 Expat maintainers + +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. diff --git a/licenses/third-party/graphviz.COPYING b/licenses/third-party/graphviz.COPYING new file mode 100644 index 0000000..e23ece2 --- /dev/null +++ b/licenses/third-party/graphviz.COPYING @@ -0,0 +1,277 @@ +Eclipse Public License - v 2.0 + + THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE + PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION + OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT. + +1. DEFINITIONS + +"Contribution" means: + + a) in the case of the initial Contributor, the initial content + Distributed under this Agreement, and + + b) in the case of each subsequent Contributor: + i) changes to the Program, and + ii) additions to the Program; + where such changes and/or additions to the Program originate from + and are Distributed by that particular Contributor. A Contribution + "originates" from a Contributor if it was added to the Program by + such Contributor itself or anyone acting on such Contributor's behalf. + Contributions do not include changes or additions to the Program that + are not Modified Works. + +"Contributor" means any person or entity that Distributes the Program. + +"Licensed Patents" mean patent claims licensable by a Contributor which +are necessarily infringed by the use or sale of its Contribution alone +or when combined with the Program. + +"Program" means the Contributions Distributed in accordance with this +Agreement. + +"Recipient" means anyone who receives the Program under this Agreement +or any Secondary License (as applicable), including Contributors. + +"Derivative Works" shall mean any work, whether in Source Code or other +form, that is based on (or derived from) the Program and for which the +editorial revisions, annotations, elaborations, or other modifications +represent, as a whole, an original work of authorship. + +"Modified Works" shall mean any work in Source Code or other form that +results from an addition to, deletion from, or modification of the +contents of the Program, including, for purposes of clarity any new file +in Source Code form that contains any contents of the Program. Modified +Works shall not include works that contain only declarations, +interfaces, types, classes, structures, or files of the Program solely +in each case in order to link to, bind by name, or subclass the Program +or Modified Works thereof. + +"Distribute" means the acts of a) distributing or b) making available +in any manner that enables the transfer of a copy. + +"Source Code" means the form of a Program preferred for making +modifications, including but not limited to software source code, +documentation source, and configuration files. + +"Secondary License" means either the GNU General Public License, +Version 2.0, or any later versions of that license, including any +exceptions or additional permissions as identified by the initial +Contributor. + +2. GRANT OF RIGHTS + + a) Subject to the terms of this Agreement, each Contributor hereby + grants Recipient a non-exclusive, worldwide, royalty-free copyright + license to reproduce, prepare Derivative Works of, publicly display, + publicly perform, Distribute and sublicense the Contribution of such + Contributor, if any, and such Derivative Works. + + b) Subject to the terms of this Agreement, each Contributor hereby + grants Recipient a non-exclusive, worldwide, royalty-free patent + license under Licensed Patents to make, use, sell, offer to sell, + import and otherwise transfer the Contribution of such Contributor, + if any, in Source Code or other form. This patent license shall + apply to the combination of the Contribution and the Program if, at + the time the Contribution is added by the Contributor, such addition + of the Contribution causes such combination to be covered by the + Licensed Patents. The patent license shall not apply to any other + combinations which include the Contribution. No hardware per se is + licensed hereunder. + + c) Recipient understands that although each Contributor grants the + licenses to its Contributions set forth herein, no assurances are + provided by any Contributor that the Program does not infringe the + patent or other intellectual property rights of any other entity. + Each Contributor disclaims any liability to Recipient for claims + brought by any other entity based on infringement of intellectual + property rights or otherwise. As a condition to exercising the + rights and licenses granted hereunder, each Recipient hereby + assumes sole responsibility to secure any other intellectual + property rights needed, if any. For example, if a third party + patent license is required to allow Recipient to Distribute the + Program, it is Recipient's responsibility to acquire that license + before distributing the Program. + + d) Each Contributor represents that to its knowledge it has + sufficient copyright rights in its Contribution, if any, to grant + the copyright license set forth in this Agreement. + + e) Notwithstanding the terms of any Secondary License, no + Contributor makes additional grants to any Recipient (other than + those set forth in this Agreement) as a result of such Recipient's + receipt of the Program under the terms of a Secondary License + (if permitted under the terms of Section 3). + +3. REQUIREMENTS + +3.1 If a Contributor Distributes the Program in any form, then: + + a) the Program must also be made available as Source Code, in + accordance with section 3.2, and the Contributor must accompany + the Program with a statement that the Source Code for the Program + is available under this Agreement, and informs Recipients how to + obtain it in a reasonable manner on or through a medium customarily + used for software exchange; and + + b) the Contributor may Distribute the Program under a license + different than this Agreement, provided that such license: + i) effectively disclaims on behalf of all other Contributors all + warranties and conditions, express and implied, including + warranties or conditions of title and non-infringement, and + implied warranties or conditions of merchantability and fitness + for a particular purpose; + + ii) effectively excludes on behalf of all other Contributors all + liability for damages, including direct, indirect, special, + incidental and consequential damages, such as lost profits; + + iii) does not attempt to limit or alter the recipients' rights + in the Source Code under section 3.2; and + + iv) requires any subsequent distribution of the Program by any + party to be under a license that satisfies the requirements + of this section 3. + +3.2 When the Program is Distributed as Source Code: + + a) it must be made available under this Agreement, or if the + Program (i) is combined with other material in a separate file or + files made available under a Secondary License, and (ii) the initial + Contributor attached to the Source Code the notice described in + Exhibit A of this Agreement, then the Program may be made available + under the terms of such Secondary Licenses, and + + b) a copy of this Agreement must be included with each copy of + the Program. + +3.3 Contributors may not remove or alter any copyright, patent, +trademark, attribution notices, disclaimers of warranty, or limitations +of liability ("notices") contained within the Program from any copy of +the Program which they Distribute, provided that Contributors may add +their own appropriate notices. + +4. COMMERCIAL DISTRIBUTION + +Commercial distributors of software may accept certain responsibilities +with respect to end users, business partners and the like. While this +license is intended to facilitate the commercial use of the Program, +the Contributor who includes the Program in a commercial product +offering should do so in a manner which does not create potential +liability for other Contributors. Therefore, if a Contributor includes +the Program in a commercial product offering, such Contributor +("Commercial Contributor") hereby agrees to defend and indemnify every +other Contributor ("Indemnified Contributor") against any losses, +damages and costs (collectively "Losses") arising from claims, lawsuits +and other legal actions brought by a third party against the Indemnified +Contributor to the extent caused by the acts or omissions of such +Commercial Contributor in connection with its distribution of the Program +in a commercial product offering. The obligations in this section do not +apply to any claims or Losses relating to any actual or alleged +intellectual property infringement. In order to qualify, an Indemnified +Contributor must: a) promptly notify the Commercial Contributor in +writing of such claim, and b) allow the Commercial Contributor to control, +and cooperate with the Commercial Contributor in, the defense and any +related settlement negotiations. The Indemnified Contributor may +participate in any such claim at its own expense. + +For example, a Contributor might include the Program in a commercial +product offering, Product X. That Contributor is then a Commercial +Contributor. If that Commercial Contributor then makes performance +claims, or offers warranties related to Product X, those performance +claims and warranties are such Commercial Contributor's responsibility +alone. Under this section, the Commercial Contributor would have to +defend claims against the other Contributors related to those performance +claims and warranties, and if a court requires any other Contributor to +pay any damages as a result, the Commercial Contributor must pay +those damages. + +5. NO WARRANTY + +EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT +PERMITTED BY APPLICABLE LAW, THE PROGRAM IS PROVIDED ON AN "AS IS" +BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR +IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF +TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR +PURPOSE. Each Recipient is solely responsible for determining the +appropriateness of using and distributing the Program and assumes all +risks associated with its exercise of rights under this Agreement, +including but not limited to the risks and costs of program errors, +compliance with applicable laws, damage to or loss of data, programs +or equipment, and unavailability or interruption of operations. + +6. DISCLAIMER OF LIABILITY + +EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT +PERMITTED BY APPLICABLE LAW, NEITHER RECIPIENT NOR ANY CONTRIBUTORS +SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, +EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST +PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE +EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + +7. GENERAL + +If any provision of this Agreement is invalid or unenforceable under +applicable law, it shall not affect the validity or enforceability of +the remainder of the terms of this Agreement, and without further +action by the parties hereto, such provision shall be reformed to the +minimum extent necessary to make such provision valid and enforceable. + +If Recipient institutes patent litigation against any entity +(including a cross-claim or counterclaim in a lawsuit) alleging that the +Program itself (excluding combinations of the Program with other software +or hardware) infringes such Recipient's patent(s), then such Recipient's +rights granted under Section 2(b) shall terminate as of the date such +litigation is filed. + +All Recipient's rights under this Agreement shall terminate if it +fails to comply with any of the material terms or conditions of this +Agreement and does not cure such failure in a reasonable period of +time after becoming aware of such noncompliance. If all Recipient's +rights under this Agreement terminate, Recipient agrees to cease use +and distribution of the Program as soon as reasonably practicable. +However, Recipient's obligations under this Agreement and any licenses +granted by Recipient relating to the Program shall continue and survive. + +Everyone is permitted to copy and distribute copies of this Agreement, +but in order to avoid inconsistency the Agreement is copyrighted and +may only be modified in the following manner. The Agreement Steward +reserves the right to publish new versions (including revisions) of +this Agreement from time to time. No one other than the Agreement +Steward has the right to modify this Agreement. The Eclipse Foundation +is the initial Agreement Steward. The Eclipse Foundation may assign the +responsibility to serve as the Agreement Steward to a suitable separate +entity. Each new version of the Agreement will be given a distinguishing +version number. The Program (including Contributions) may always be +Distributed subject to the version of the Agreement under which it was +received. In addition, after a new version of the Agreement is published, +Contributor may elect to Distribute the Program (including its +Contributions) under the new version. + +Except as expressly stated in Sections 2(a) and 2(b) above, Recipient +receives no rights or licenses to the intellectual property of any +Contributor under this Agreement, whether expressly, by implication, +estoppel or otherwise. All rights in the Program not expressly granted +under this Agreement are reserved. Nothing in this Agreement is intended +to be enforceable by any entity that is not a Contributor or Recipient. +No third-party beneficiary rights are created under this Agreement. + +Exhibit A - Form of Secondary Licenses Notice + +"This Source Code may also be made available under the following +Secondary Licenses when the conditions for such availability set forth +in the Eclipse Public License, v. 2.0 are satisfied: {name license(s), +version(s), and exceptions or additional permissions here}." + + Simply including a copy of this Agreement, including this Exhibit A + is not sufficient to license the Source Code under Secondary Licenses. + + If it is not possible or desirable to put the notice in a particular + file, then You may include the notice in a location (such as a LICENSE + file in a relevant directory) where a recipient would be likely to + look for such a notice. + + You may add additional accurate notices of copyright ownership. \ No newline at end of file diff --git a/licenses/third-party/viz-js.LICENSE b/licenses/third-party/viz-js.LICENSE new file mode 100644 index 0000000..214cfc3 --- /dev/null +++ b/licenses/third-party/viz-js.LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) Michael Daines + +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. diff --git a/packages/cli/package.json b/packages/cli/package.json index 4022862..6fb9d83 100644 --- a/packages/cli/package.json +++ b/packages/cli/package.json @@ -21,6 +21,7 @@ "@topo/diagram-core": "workspace:*", "@topo/enrichment": "workspace:*", "@topo/graph": "workspace:*", + "@topo/languages": "workspace:*", "@topo/modules": "workspace:*", "@topo/reports": "workspace:*", "@topo/scanner": "workspace:*", diff --git a/packages/cli/src/catalogue.ts b/packages/cli/src/catalogue.ts index 9c6065e..5d9f7b9 100644 --- a/packages/cli/src/catalogue.ts +++ b/packages/cli/src/catalogue.ts @@ -3,12 +3,14 @@ import { execFile } from "node:child_process"; import { readFile, readdir, rm, stat } from "node:fs/promises"; import { resolve } from "node:path"; import { promisify } from "node:util"; -import { renderStory } from "@topo/diagram-core"; +import { CORE_THEME_SCRIPT, renderStory } from "@topo/diagram-core"; import { parseStoryDocument, resolveStoryDocument, type StoryDocument, type StoryRenderer, + type ResolvedSourceAnchor, + type StoryArtifact, } from "@topo/story"; import { writeGenerated, @@ -16,6 +18,8 @@ import { isMissing, loadConfig, withWorkspaceLock, + withGeneratedTransaction, + removeGenerated, type WorkspaceCatalogueConfig, } from "@topo/workspace"; import { @@ -37,10 +41,9 @@ export interface CatalogueStory { readonly modified: number | null; }; readonly contents: string; - readonly renderer: { - readonly name: string; - readonly pin: string; - }; + readonly renderer: StoryArtifact["renderer"]; + readonly anchors?: readonly ResolvedSourceAnchor[]; + readonly assets?: Readonly>; } export interface BuiltCatalogue { @@ -89,6 +92,7 @@ export async function initializeSite(root: string, assets: string): Promise => [name, await readFile(resolve(assets, name))])), ["shell.js", SHELL_SCRIPT], + ["theme.js", CORE_THEME_SCRIPT], ["site-state.json", `${JSON.stringify({ schemaVersion: "1.0", kind: "unscanned", repositoryId: config.repositoryId, })}\n`], @@ -295,9 +299,12 @@ export async function buildCatalogue( documentPath, history, contents: artifact.contents, - renderer: { - name: artifact.renderer.name, - pin: artifact.renderer.pin, + renderer: artifact.renderer, + anchors: resolved.anchors, + assets: { + ...artifact.assets, + "evidence.json": `${JSON.stringify({ source: resolved.source, anchors: resolved.anchors, connections: document.connections }, null, 2)}\n`, + "receipt.json": `${JSON.stringify(artifact.renderer, null, 2)}\n`, }, }; })); @@ -416,11 +423,18 @@ const STORY_NAVIGATION_SCRIPT = `(() => { const child = frame.contentWindow; const childDocument = frame.contentDocument; if (!child || !childDocument) return; + const focus = params.get("focus") || ""; + for (const evidence of document.querySelectorAll("[data-section-evidence]")) { + evidence.hidden = Boolean(focus) && evidence.dataset.sectionEvidence !== focus; + } const syncSelectedNode = () => { const focus = new URLSearchParams(child.location.hash.replace(/^#/, "")).get("focus"); if (!focus) return; const candidates = crossLinks.filter((link) => link.getAttribute("data-source-node") === focus); - rememberFocus(focus); + const current = new URL(window.location.href); + current.searchParams.set("focus", focus); + window.history.replaceState(null, "", current); + for (const evidence of document.querySelectorAll("[data-section-evidence]")) evidence.hidden = evidence.dataset.sectionEvidence !== focus; if (diagramFamily !== "sequence" && candidates.length === 1) { follow(candidates[0]); } @@ -438,18 +452,12 @@ async function retireLegacySiteEntries( retireLegacyAssets: boolean, ): Promise { await Promise.all([ - rm(await workspacePath(root, "cache/site/explorer"), { - recursive: true, - force: true, - }), + removeGenerated(root, "cache/site/explorer"), ...(retireLegacyAssets - ? [rm(await workspacePath(root, "cache/site/assets"), { - recursive: true, - force: true, - })] + ? [removeGenerated(root, "cache/site/assets")] : []), ...["favicon.svg", "main.js", "styles.css"].map(async (name) => - rm(await workspacePath(root, `cache/site/${name}`), { force: true })), + removeGenerated(root, `cache/site/${name}`)), ]); const storyRoot = await workspacePath(root, "cache/site/stories"); const expected = new Set(stories.map(({ document }) => document.id)); @@ -464,10 +472,7 @@ async function retireLegacySiteEntries( } await Promise.all(entries .filter((entry) => !expected.has(entry.name)) - .map(async (entry) => rm( - await workspacePath(root, `cache/site/stories/${entry.name}`), - { recursive: entry.isDirectory(), force: true }, - ))); + .map(async (entry) => removeGenerated(root, `cache/site/stories/${entry.name}`))); } const SHELL_SCRIPT = `(() => { @@ -829,13 +834,21 @@ export function renderStoryWrapper( const crossLinks = (linksByNode.get(section.id) ?? []).map((link) => `Open ${escapeHtml(link.targetStoryTitle)}: ${escapeHtml(link.targetNodeTitle)}`, ).join(""); + const evidence = (story.anchors ?? []).filter((anchor) => section.anchorIds.includes(anchor.id)).map((anchor) => + `
${escapeHtml(anchor.path)}:${anchor.location.startLine}-${anchor.location.endLine}
${escapeHtml(anchor.excerpt)}
`).join(""); + const traces = story.document.connections.filter((edge) => edge.from === section.id || edge.to === section.id).filter((edge) => edge.classification).map((edge) => { + const excerpts = (story.anchors ?? []).filter((anchor) => edge.anchorIds?.includes(anchor.id)).map((anchor) => + `
${escapeHtml(anchor.path)}:${anchor.location.startLine}
${escapeHtml(anchor.excerpt)}
`).join(""); + return `

${escapeHtml(edge.classification!)}: ${escapeHtml(edge.label ?? `${edge.from} to ${edge.to}`)} ${escapeHtml(edge.rationale ?? "")}

${excerpts}`; + }).join(""); return `
  • ${escapeHtml(section.title)} ${crossLinks} +

    ${escapeHtml(section.body)}

    ${evidence}${traces}
  • `; }).join("\n"); return renderShellPage(stories, config, historyIncomplete, story, `\ - +
    Story navigation and details
    @@ -923,6 +936,7 @@ function renderShellPage( ${escapeHtml(title)} | Topocode + @@ -1084,6 +1117,7 @@ function renderShellPage(