weavatrix 0.2.13 → 0.2.15

package/src/mcp/tools-actions.mjs

@@ -1,414 +1,18 @@
-// Action tools: rebuild the graph, the explicit 'retarget' group, and the explicit 'online' group
-// (the ONLY tools that ever touch the network).
-// Hot-reloadable (re-imported by catalog.mjs on change).
-import {readFileSync, writeFileSync, existsSync, statSync, realpathSync} from 'node:fs'
-import {dirname, join, isAbsolute} from 'node:path'
-import {createHash} from 'node:crypto'
-import {prevGraphPathFor, diffGraphs, formatGraphDiff, graphStaleness} from './graph-context.mjs'
-import {buildGraphForRepo, defaultPrecisionMode} from '../build-graph.js'
-import {graphHomeDir, graphOutDirForModule, graphOutDirForRepo} from '../graph/layout.js'
-import {liveRepositoryRecords, registerRepository, repositoryRecord} from '../graph/repo-registry.js'
-import {refreshAdvisories, storeMeta, DEFAULT_STORE} from '../security/advisory-store.js'
-import {collectInstalled} from '../security/installed.js'
-import {createSyncPayload, createSyncPayloadV3, MAX_SYNC_BODY_BYTES} from './sync-payload.mjs'
-import {createEvidenceSnapshot} from './evidence-snapshot.mjs'
-import {writeCachedArchitectureContract} from '../analysis/architecture-contract.js'
-import {precisionSemanticInputsMatch, readPrecisionOverlay} from '../precision/lsp-overlay.js'
-import {toolResult} from './tool-result.mjs'
-
-const MAX_SYNC_GRAPH_FILE_BYTES = 64 * 1024 * 1024
-const SYNC_PREVIEW_TTL_MS = 5 * 60 * 1000
-const MAX_SYNC_PREVIEWS = 4
-const syncPreviews = new Map()
-
-function syncRepoLabel(repoRoot) {
-    const basename = String(repoRoot || '').replace(/[\\/]+$/, '').split(/[\\/]/).pop() || 'repo'
-    const safe = basename.normalize('NFKC').replace(/[^a-z0-9._-]+/gi, '-').replace(/^-+|-+$/g, '')
-    return (safe || 'repo').slice(0, 128)
-}
-
-function syncDestination(raw) {
-    let url
-    try { url = new URL(raw) } catch { throw new Error('WEAVATRIX_SYNC_URL is invalid') }
-    if (!['http:', 'https:'].includes(url.protocol)) throw new Error('WEAVATRIX_SYNC_URL must use HTTPS (or HTTP for loopback development)')
-    if (url.username || url.password) throw new Error('WEAVATRIX_SYNC_URL must not contain embedded credentials; use WEAVATRIX_SYNC_TOKEN')
-    if (url.hash) throw new Error('WEAVATRIX_SYNC_URL must not contain a fragment')
-    const loopback = ['localhost', '127.0.0.1', '[::1]', '::1'].includes(url.hostname.toLowerCase())
-    if (url.protocol !== 'https:' && !loopback) throw new Error('WEAVATRIX_SYNC_URL must use HTTPS unless the destination is loopback')
-    const display = `${url.origin}${url.pathname}${url.search ? ' (query redacted)' : ''}`
-    return {url: url.toString(), display}
-}
-
-function pruneSyncPreviews(now = Date.now()) {
-    for (const [token, preview] of syncPreviews) if (preview.expiresAt <= now) syncPreviews.delete(token)
-    while (syncPreviews.size >= MAX_SYNC_PREVIEWS) syncPreviews.delete(syncPreviews.keys().next().value)
-}
-
-function confirmationToken({url, repositoryId, payloadVersion, bodyHash}) {
-    return createHash('sha256')
-        .update(`weavatrix-sync-preview-v1\0${url}\0${repositoryId}\0${payloadVersion}\0${bodyHash}`)
-        .digest('hex').slice(0, 24)
-}
-
-function syncSectionSummary(payload) {
-    if (payload.syncPayloadV !== 3) return 'graph topology only (explicit V2 compatibility mode)'
-    const sections = payload.evidence?.sections || {}
-    const names = Object.entries(sections).map(([name, section]) => `${name}:${section?.state || section?.verdict || 'included'}`)
-    return names.join(', ') || 'bounded architecture/health/stack/package/duplicate evidence'
-}
-
-function syncPreviewText(preview, {expired = false} = {}) {
-    return [
-        `SYNC PREVIEW${expired ? ' (the supplied confirmation was missing, expired, or did not match)' : ''} — no network request was made.`,
-        `Destination: ${preview.destinationDisplay}.`,
-        `Repository: ${preview.repoName}; opaque repository UUID: ${preview.repositoryId}.`,
-        `Payload V${preview.payload.syncPayloadV}: ${preview.payload.nodes.length} nodes / ${preview.payload.links.length} edges, ${Math.round(preview.bodyBytes / 1024)} KB; body SHA-256 ${preview.bodyHash.slice(0, 12)}.`,
-        `Payload fields: ${Object.keys(preview.payload).sort().join(', ')}.`,
-        `Included sections: ${syncSectionSummary(preview.payload)}.`,
-        'Excluded by the wire allowlist: source bodies, snippets, absolute host paths, environment values, credentials, Git remotes, and unknown fields.',
-        `After the user approves this exact destination and summary, call sync_graph again within 5 minutes with dry_run:false and confirm_token: "${preview.token}".`,
-    ].join('\n')
-}
-
-async function sendSyncPreview(preview, timeoutMs) {
-    try {
-        const res = await fetch(preview.url, {
-            method: 'POST',
-            headers: {
-                'content-type': 'application/json',
-                'x-weavatrix-payload-version': String(preview.payload.syncPayloadV),
-                'x-weavatrix-repo': preview.repoName,
-                'x-weavatrix-repository-id': preview.repositoryId,
-                ...(process.env.WEAVATRIX_SYNC_TOKEN ? {authorization: `Bearer ${process.env.WEAVATRIX_SYNC_TOKEN}`} : {}),
-            },
-            body: preview.body,
-            signal: AbortSignal.timeout(timeoutMs),
-        })
-        if (!res.ok) {
-            const accepted = res.headers?.get?.('x-weavatrix-accept-payload-versions')
-            const compatibility = (res.status === 415 || res.status === 422) && accepted
-                ? ` Endpoint accepts payload version(s) ${accepted}; create and approve a new V2 preview only if graph-only sync is intentional.`
-                : ''
-            return `Sync endpoint ${preview.destinationDisplay} answered HTTP ${res.status} — graph NOT accepted.${compatibility}`
-        }
-        syncPreviews.delete(preview.token)
-        const evidenceNote = preview.payload.syncPayloadV === 3
-            ? ` + evidence ${preview.payload.evidence?.snapshotHash?.slice(0, 12) || 'unknown'}`
-            : ''
-        return `Graph for ${preview.repoName} (${preview.payload.nodes.length} nodes / ${preview.payload.links.length} edges${evidenceNote}, ${Math.round(preview.bodyBytes / 1024)} KB) pushed to approved destination ${preview.destinationDisplay}.`
-    } catch (error) {
-        return `Sync failed: ${error.message} — the graph stays local; the approved preview remains retryable until it expires.`
-    }
-}
-
-export async function tRebuildGraph(g, args, ctx) {
-    if (!ctx.repoRoot) return 'Rebuild needs the repo root (not provided to this server).'
-    const mode = ['no-tests', 'tests-only', 'full'].includes(args.mode)
-        ? args.mode
-        : ['no-tests', 'tests-only', 'full'].includes(g?.graphBuildMode) ? g.graphBuildMode : 'full'
-    const precision = args.precision === 'off' ? 'off' : args.precision === 'lsp' ? 'lsp' : (g?.graphPrecisionMode || defaultPrecisionMode())
-    const scope = String(args.scope || '').replace(/\\/g, '/').replace(/^\/+|\/+$/g, '')
-    if (scope) {
-        const scopedDir = graphOutDirForModule(ctx.repoRoot, scope)
-        const scoped = await buildGraphForRepo(ctx.repoRoot, {mode, scope, precision, outDir: scopedDir})
-        if (!scoped || !scoped.ok) return `Scoped graph build failed: ${(scoped && scoped.error) || 'unknown error'}`
-        return [
-            `Built an isolated scoped graph for ${scope} (${mode}). ${scoped.log || ''}.`,
-            `The active full-repository graph was not replaced, so this operation cannot report a false full→scope structural delta.`,
-            `Scoped graph: ${join(scopedDir, 'graph.json')}`,
-        ].join('\n')
-    }
-    // snapshot the outgoing state: bytes → graph.prev.json (for graph_diff later), struct → inline delta
-    let prevBytes = null
-    try { prevBytes = readFileSync(ctx.graphPath) } catch { /* first build — nothing to diff against */ }
-    let before = null
-    try { before = prevBytes ? JSON.parse(prevBytes.toString('utf8')) : null } catch { before = null }
-    const res = await buildGraphForRepo(ctx.repoRoot, {mode, scope: '', precision, outDir: ctx.graphPath ? dirname(ctx.graphPath) : undefined})
-    if (!res || !res.ok) return `Graph rebuild failed: ${(res && res.error) || 'unknown error'}`
-    if (prevBytes) { try { writeFileSync(prevGraphPathFor(ctx.graphPath), prevBytes) } catch { /* snapshot is best-effort */ } }
-    const fresh = ctx.reload() // refresh THIS server's in-memory graph so subsequent tool calls see the new graph
-    let afterStatic = null
-    try { afterStatic = JSON.parse(readFileSync(ctx.graphPath, 'utf8')) } catch { /* reload already reports the failure */ }
-    const beforeMode = ['full', 'no-tests', 'tests-only'].includes(before?.graphBuildMode) ? before.graphBuildMode : 'full'
-    const afterMode = ['full', 'no-tests', 'tests-only'].includes(afterStatic?.graphBuildMode) ? afterStatic.graphBuildMode : 'full'
-    const delta = before && afterStatic
-        ? beforeMode === afterMode
-            ? formatGraphDiff(diffGraphs(before, afterStatic))
-            : `Structural delta not computed: build mode changed from ${beforeMode} to ${afterMode}, so the node/edge universes are not comparable.`
-        : null
-    return [
-        `Rebuilt the graph (${mode}). ${res.log || ''}. In-memory graph reloaded — graph tools now reflect it.`,
-        delta
-    ].filter(Boolean).join('\n\n')
-}
-
-// Retarget this server at ANOTHER local repository at runtime — one weavatrix registration serves any
-// repo. Loads <parent>/weavatrix-graphs/<name>/graph.json (the central layout graphs
-// always live in), building it first when missing. On a failed load the previous repo stays active.
-export async function tOpenRepo(g, args, ctx) {
-    const requestedPath = String(args.path || '').trim()
-    if (!requestedPath) return 'Provide "path" — an absolute path to a local repository folder.'
-    if (!isAbsolute(requestedPath)) return 'open_repo requires an absolute repository path.'
-    let repoPath
-    try { repoPath = realpathSync.native(requestedPath) } catch { return `Path not found: ${requestedPath}` }
-    try { if (!statSync(repoPath).isDirectory()) return `Not a directory: ${requestedPath}` } catch { return `Path not found: ${requestedPath}` }
-    if (!existsSync(join(repoPath, '.git'))) return `Not a Git repository: ${requestedPath}`
-    const graphPath = join(graphOutDirForRepo(repoPath), 'graph.json')
-    const graphExists = existsSync(graphPath)
-    const requestedMode = ['no-tests', 'tests-only', 'full'].includes(args.mode) ? args.mode : null
-    const requestedPrecision = ['lsp', 'off'].includes(args.precision) ? args.precision : null
-    let built = false
-    let upgrade = false
-    let schemaUpgrade = false
-    let precisionUpgrade = false
-    let savedMode = 'full'
-    let savedPrecision = defaultPrecisionMode()
-    if (graphExists) {
-        try {
-            const saved = JSON.parse(readFileSync(graphPath, 'utf8'))
-            savedMode = ['no-tests', 'tests-only', 'full'].includes(saved.graphBuildMode) ? saved.graphBuildMode : 'full'
-            savedPrecision = ['lsp', 'off'].includes(saved.graphPrecisionMode) ? saved.graphPrecisionMode : defaultPrecisionMode()
-            schemaUpgrade = !Number.isInteger(saved.edgeTypesV) || saved.edgeTypesV < 2
-                || !Number.isInteger(saved.edgeProvenanceV) || saved.edgeProvenanceV < 1
-                || !Number.isInteger(saved.extractorSchemaV) || saved.extractorSchemaV < 5
-                || !Number.isInteger(saved.reExportOccurrencesV) || saved.reExportOccurrencesV < 1
-                || !Number.isInteger(saved.symbolSpacesV) || saved.symbolSpacesV < 1
-            if (savedPrecision === 'lsp') {
-                const overlay = readPrecisionOverlay(graphPath, saved)
-                precisionUpgrade = !overlay || (typeof overlay.semanticInputFingerprint === 'string'
-                    && !precisionSemanticInputsMatch(overlay, repoPath, saved))
-            }
-            upgrade = schemaUpgrade || precisionUpgrade
-        } catch {
-            upgrade = true
-        }
-    }
-    const modeMismatch = graphExists && requestedMode != null && requestedMode !== savedMode
-    const precisionMismatch = graphExists && requestedPrecision != null && requestedPrecision !== savedPrecision
-    if (!graphExists || upgrade || modeMismatch || precisionMismatch) {
-        if (args.build === false) {
-            if (modeMismatch && !upgrade) {
-                return `The existing graph for ${repoPath} was built in ${savedMode}, but ${requestedMode} was requested. Re-call without build:false to rebuild it before switching.`
-            }
-            if (precisionMismatch && !upgrade) {
-                return `The existing graph for ${repoPath} uses semantic precision ${savedPrecision}, but ${requestedPrecision} was requested. Re-call without build:false to rebuild it before switching.`
-            }
-            return upgrade
-                ? precisionUpgrade && !schemaUpgrade
-                    ? `The existing graph for ${repoPath} lacks current revision-matched semantic precision evidence. Re-call without build:false to refresh it before switching.`
-                    : `The existing graph for ${repoPath} predates current typed-edge/provenance metadata. Re-call without build:false to upgrade it before switching.`
-                : `No graph yet for ${repoPath} (expected at ${graphPath}). Re-call without build:false to build one — large repos can take minutes.`
-        }
-        const mode = requestedMode || (graphExists ? savedMode : 'full')
-        const precision = requestedPrecision || (graphExists ? savedPrecision : defaultPrecisionMode())
-        const res = await buildGraphForRepo(repoPath, {mode, scope: '', precision})
-        if (!res || !res.ok) return `Graph build failed for ${repoPath}: ${(res && res.error) || 'unknown error'}`
-        built = true
-    }
-    const prev = {graphPath: ctx.graphPath, repoRoot: ctx.repoRoot}
-    ctx.graphPath = graphPath
-    ctx.repoRoot = repoPath
-    const loaded = ctx.reload()
-    if (!loaded) {
-        ctx.graphPath = prev.graphPath
-        ctx.repoRoot = prev.repoRoot
-        ctx.reload()
-        return `Failed to load ${graphPath} — still targeting the previous repo (${prev.repoRoot || 'none'}).`
-    }
-    registerRepository({repoPath, graphDir: graphOutDirForRepo(repoPath), graphHome: graphHomeDir()})
-    const buildNote = built ? (upgrade ? ' (graph upgraded to current edge/precision metadata)' : modeMismatch ? ' (graph rebuilt in the requested mode)' : precisionMismatch ? ' (semantic precision mode updated)' : ' (graph built fresh)') : ''
-    return [
-        `Opened ${repoPath}${buildNote}: ${loaded.nodes.length} nodes / ${loaded.links.length} edges. All tools now target this repo.`,
-        `Graph: ${graphPath}`,
-        `Build mode: ${loaded.graphBuildMode || 'full'}`,
-        `Semantic precision: ${loaded.precision?.state || 'UNAVAILABLE'} (${loaded.precision?.verifiedEdges || 0} EXACT_LSP edge(s))`,
-    ].join('\n')
-}
-
-// Sibling repos that already have a built graph in the central weavatrix-graphs folder — open_repo candidates.
-export function tListKnownRepos(g, args, ctx) {
-    const root = graphHomeDir()
-    const norm = (p) => String(p).replace(/[\\/]+/g, '/').toLowerCase()
-    const rows = liveRepositoryRecords(root).map((record) => ({
-        ...record,
-        builtAt: statSync(join(record.graphDir, 'graph.json')).mtime.toISOString(),
-    }))
-    if (!rows.length) return `No registered graphs under ${root}. Build a repository once with open_repo or rebuild_graph.`
-    return [
-        `Known repositories (${rows.length}) in ${root}:`,
-        ...rows.map((r) => `  ${norm(r.repoPath) === norm(ctx.repoRoot) ? '»' : ' '} ${r.label} [${r.repositoryId}] — graph built ${r.builtAt}  (${r.repoPath})`),
-    ].join('\n')
-}
-
-// ---- online tools ('online' capability group) -----------------------------------------------------
-// Scans and graph queries stay 100% offline. These two run a network call ONLY when explicitly
-// invoked; registering the server with a caps list that omits 'online' removes them entirely.
-
-// Refresh the local OSV advisory store for the current repo's lockfile-pinned packages. What leaves
-// the machine: package names + versions (that is what an OSV query IS) — never source code.
-export async function tRefreshAdvisories(g, args, ctx) {
-    if (!ctx.repoRoot) return 'No repo root — cannot collect installed packages.'
-    const {installed} = collectInstalled(ctx.repoRoot)
-    if (!installed.length) return 'No pinned packages found in lockfiles (npm/yarn/pip/poetry/uv/go) — nothing to query.'
-    const res = await refreshAdvisories({installed, repoKey: ctx.repoRoot, timeoutMs: Number(args.timeout_ms) || undefined})
-    if (res.ok === false) return `Advisory refresh failed: ${res.error}`
-    const meta = storeMeta()
-    return [
-        `Advisory store ${res.status === 'PARTIAL' ? 'partially refreshed' : 'refreshed'} from OSV.dev: ${res.queriedOk ?? res.queried}/${res.queried} package versions queried successfully, ${res.vulnerable} with known advisories (${res.fetched} advisory records fetched).`,
-        res.unsupported ? `${res.unsupported} packages skipped (ecosystem not OSV-queryable — npm/PyPI/Go only).` : null,
-        res.errors?.length ? `Partial: ${res.errors.length} request error(s), first: ${res.errors[0]}` : null,
-        `Store: ${DEFAULT_STORE} (${meta.advisoryCount} advisories, fetched ${meta.fetchedAt}). run_audit now reflects it — offline.`,
-    ].filter(Boolean).join('\n')
-}
-
-export async function tPullArchitectureContract(g, args, ctx) {
-    if (!ctx.repoRoot || !ctx.graphPath) return 'No active repository graph — open_repo first.'
-    const syncUrl = process.env.WEAVATRIX_SYNC_URL
-    const token = process.env.WEAVATRIX_SYNC_TOKEN
-    if (!syncUrl || !token) return 'Hosted architecture pull is not configured. Use the hosted profile with WEAVATRIX_SYNC_URL and WEAVATRIX_SYNC_TOKEN, or keep .weavatrix/architecture.json locally.'
-    let url
-    try {
-        const configured = process.env.WEAVATRIX_ARCHITECTURE_URL || new URL('/api/v1/architecture-contract', syncUrl).toString()
-        url = syncDestination(configured).url
-    } catch (error) { return `Hosted architecture pull is not configured safely: ${error.message}.` }
-    const registry = repositoryRecord(ctx.repoRoot, graphHomeDir())
-        || registerRepository({repoPath: ctx.repoRoot, graphDir: graphOutDirForRepo(ctx.repoRoot), graphHome: graphHomeDir()})
-    const timeoutMs = Math.min(120000, Math.max(1000, Number(args.timeout_ms) || 30000))
-    try {
-        const res = await fetch(url, {
-            headers: {authorization: `Bearer ${token}`, 'x-weavatrix-repository-id': registry.repositoryId},
-            signal: AbortSignal.timeout(timeoutMs),
-        })
-        const body = await res.json().catch(() => null)
-        if (!res.ok) {
-            const serverCode = String(body?.error?.code || body?.state || '').toUpperCase()
-            const state = res.status === 401 ? 'AUTH_REQUIRED'
-                : res.status === 403 ? 'FORBIDDEN'
-                    : res.status === 404 && ['REPOSITORY_NOT_FOUND', 'NOT_FOUND'].includes(serverCode) ? 'REPOSITORY_NOT_REGISTERED'
-                        : res.status === 404 ? 'ENDPOINT_NOT_FOUND'
-                        : res.status === 409 ? 'REPOSITORY_NOT_READY'
-                            : 'HTTP_ERROR'
-            const next = state === 'REPOSITORY_NOT_REGISTERED'
-                ? 'The Hosted endpoint is reachable, but this UUID has not completed a preview-confirmed repository sync.'
-                : state === 'ENDPOINT_NOT_FOUND'
-                    ? 'The configured architecture endpoint does not exist; verify WEAVATRIX_ARCHITECTURE_URL or the URL derived from WEAVATRIX_SYNC_URL.'
-                : res.status === 401 || res.status === 403
-                    ? 'Check the hosted token and repository access; no local cache entry was changed.'
-                    : res.status === 409
-                        ? 'Sync/register this repository first, then create or pull its target contract.'
-                        : 'Check the hosted service status and configured endpoint before retrying.'
-            return toolResult(`Hosted architecture pull: ${state} (HTTP ${res.status}). ${next} The previous local contract cache remains unchanged.`, {
-                state, httpStatus: res.status, serverCode: serverCode || null, cacheChanged: false,
-            })
-        }
-        if (body?.state === 'NOT_CONFIGURED' || !body?.contract) return toolResult(
-            'Hosted target architecture is NOT_CONFIGURED. Repository sync and authentication succeeded; define and save a target in the Architecture editor first.',
-            {state: 'NOT_CONFIGURED', repositoryId: registry.repositoryId, cacheChanged: false},
-        )
-        const stored = writeCachedArchitectureContract(ctx.graphPath, body.contract)
-        return `Pulled target architecture ${stored.contract.name} (${stored.contract.style}, ${stored.contract.enforcement}) into the local graph cache. get_architecture_contract and verify_architecture now use it.`
-    } catch (error) {
-        return `Hosted architecture pull failed: ${error.message}; the previous local contract, if any, remains active.`
-    }
-}
-
-async function buildSyncPreview(g, args, ctx) {
-    const configuredUrl = process.env.WEAVATRIX_SYNC_URL
-    if (!configuredUrl) {
-        return 'Graph sync is not configured (optional feature). Set WEAVATRIX_SYNC_URL to the upload endpoint'
-            + ' (and WEAVATRIX_SYNC_TOKEN for bearer auth) in the MCP registration env, then call again.'
-    }
-    let destination
-    try { destination = syncDestination(configuredUrl) }
-    catch (error) { return `Graph sync is not configured safely: ${error.message}.` }
-    if (!g) return 'No graph loaded — build one first (open_repo / rebuild_graph).'
-    let raw
-    try {
-        const size = statSync(ctx.graphPath).size
-        if (size > MAX_SYNC_GRAPH_FILE_BYTES) {
-            return `Cannot sync: graph.json is ${Math.ceil(size / 1024 / 1024)} MB; the local safety limit is ${MAX_SYNC_GRAPH_FILE_BYTES / 1024 / 1024} MB.`
-        }
-        raw = JSON.parse(readFileSync(ctx.graphPath, 'utf8'))
-    } catch (e) { return `Cannot read ${ctx.graphPath}: ${e.message}` }
-    const requestedVersion = Number(args.payload_version) === 2 ? 2 : 3
-    let payload
-    try {
-        if (requestedVersion === 2) {
-            payload = createSyncPayload(raw)
-        } else {
-            if (!ctx.repoRoot) return 'Cannot build evidence: no repository root is active.'
-            if (graphStaleness(ctx).stale) {
-                return 'Cannot sync evidence from a stale graph. Run rebuild_graph, then call sync_graph again.'
-            }
-            const evidence = await createEvidenceSnapshot({repoRoot: ctx.repoRoot, graph: raw})
-            payload = createSyncPayloadV3(raw, evidence)
-        }
-    } catch (e) {
-        return `Cannot sync: ${e.message}. Run rebuild_graph once before sync_graph.`
-    }
-    const body = JSON.stringify(payload)
-    const bodyBytes = Buffer.byteLength(body)
-    if (bodyBytes > MAX_SYNC_BODY_BYTES) {
-        return `Cannot sync: payload is ${Math.ceil(bodyBytes / 1024)} KB; the hosted safety limit is ${MAX_SYNC_BODY_BYTES / 1024} KB. Narrow the graph scope and rebuild before retrying.`
-    }
-    const repoName = syncRepoLabel(ctx.repoRoot)
-    const registry = repositoryRecord(ctx.repoRoot, graphHomeDir())
-        || registerRepository({repoPath: ctx.repoRoot, graphDir: graphOutDirForRepo(ctx.repoRoot), graphHome: graphHomeDir()})
-    const bodyHash = createHash('sha256').update(body).digest('hex')
-    const token = confirmationToken({url: destination.url, repositoryId: registry.repositoryId, payloadVersion: payload.syncPayloadV, bodyHash})
-    const preview = {
-        token, url: destination.url, destinationDisplay: destination.display,
-        graphPath: ctx.graphPath, repoName, repositoryId: registry.repositoryId,
-        payload, body, bodyBytes, bodyHash, expiresAt: Date.now() + SYNC_PREVIEW_TTL_MS,
-    }
-    syncPreviews.set(token, preview)
-    return preview
-}
-
-function previewResult(preview, {expired = false} = {}) {
-    if (typeof preview === 'string') return preview
-    return toolResult(syncPreviewText(preview, {expired}), {
-        status: 'PREVIEW_READY', networkRequestMade: false,
-        destination: preview.destinationDisplay, repository: preview.repoName,
-        repositoryId: preview.repositoryId, payloadVersion: preview.payload.syncPayloadV,
-        nodes: preview.payload.nodes.length, links: preview.payload.links.length,
-        bodyBytes: preview.bodyBytes, bodyHash: preview.bodyHash,
-        payloadFields: Object.keys(preview.payload).sort(), sections: syncSectionSummary(preview.payload),
-        expiresAt: new Date(preview.expiresAt).toISOString(), confirmToken: preview.token,
-    }, {completeness: {status: 'COMPLETE', reason: 'exact allowlisted payload serialized locally; no network request made'}})
-}
-
-// Build the exact upload body and approval token without any network request. Kept separate from the
-// mutating tool so safety layers and humans can approve a local preview without authorizing egress.
-export async function tPreviewSyncGraph(g, args, ctx) {
-    pruneSyncPreviews()
-    return previewResult(await buildSyncPreview(g, args, ctx))
-}
-
-// Push the exact payload previously approved through preview_sync. The old dry_run form remains a
-// compatibility alias for one release, but can never send unless dry_run:false and the token matches.
-export async function tSyncGraph(g, args, ctx) {
-    if (args.dry_run !== false) {
-        pruneSyncPreviews()
-        const preview = await buildSyncPreview(g, args, ctx)
-        if (typeof preview === 'string') return preview
-        const suppliedToken = String(args.confirm_token || '').trim()
-        const exact = suppliedToken && suppliedToken === preview.token
-        return `${syncPreviewText(preview, {expired: !!suppliedToken && !exact})}${exact ? '\nConfirmation token recognized, but dry_run is still true; no network request was made.' : ''}`
-    }
-    const configuredUrl = process.env.WEAVATRIX_SYNC_URL
-    if (!configuredUrl) return 'Graph sync is not configured (optional feature). Set WEAVATRIX_SYNC_URL first.'
-    let destination
-    try { destination = syncDestination(configuredUrl) }
-    catch (error) { return `Graph sync is not configured safely: ${error.message}.` }
-    pruneSyncPreviews()
-    const suppliedToken = String(args.confirm_token || '').trim()
-    const approved = suppliedToken ? syncPreviews.get(suppliedToken) : null
-    if (approved && approved.expiresAt > Date.now()
-        && approved.url === destination.url && approved.graphPath === ctx.graphPath) {
-        const timeoutMs = Math.min(120000, Math.max(1000, Number(args.timeout_ms) || 30000))
-        return sendSyncPreview(approved, timeoutMs)
-    }
-    const preview = await buildSyncPreview(g, args, ctx)
-    return typeof preview === 'string' ? preview : syncPreviewText(preview, {expired: true})
-}
+// Propagate catalog.mjs's cache-busting query to owner modules so development hot reload remains
+// behaviorally identical to the former single-file implementation.
+const version = new URL(import.meta.url).search
+const load = (path) => import(new URL(`${path}${version}`, import.meta.url).href)
+const [lifecycle, advisories, architecture, sync] = await Promise.all([
+  load('./actions/graph-lifecycle.mjs'),
+  load('./actions/advisories.mjs'),
+  load('./actions/hosted-architecture.mjs'),
+  load('./actions/graph-sync.mjs'),
+])
+
+export const tOpenRepo = lifecycle.tOpenRepo
+export const tListKnownRepos = lifecycle.tListKnownRepos
+export const tRebuildGraph = lifecycle.tRebuildGraph
+export const tRefreshAdvisories = advisories.tRefreshAdvisories
+export const tPullArchitectureContract = architecture.tPullArchitectureContract
+export const tPreviewSyncGraph = sync.tPreviewSyncGraph
+export const tSyncGraph = sync.tSyncGraph

package/src/mcp/tools-architecture.mjs

@@ -5,21 +5,14 @@ import {createPathClassifier, hasPathClass} from '../path-classification.js'
 import {detectRepoStack} from '../scan/discover.js'
 import {toolResult} from './tool-result.mjs'
 
-const PROVISIONAL_BUDGETS = Object.freeze({
-    runtimeCycles: 0,
-    maxFileLoc: 300,
-    maxFunctionLoc: 120,
-    maxCyclomatic: 15,
-    maxModuleFiles: 80,
-    minModuleCohesion: .5,
-    maxModuleBoundaryRatio: .65,
-})
-
-const SOURCE_ROOTS = new Set(['src', 'app', 'lib', 'packages', 'services'])
-const PRODUCT_CODE_EXTENSIONS = new Set([
-    '.cjs', '.cs', '.css', '.go', '.htm', '.html', '.java', '.js', '.jsx', '.less', '.mjs', '.py', '.pyi',
-    '.rs', '.scss', '.ts', '.tsx',
+const version = new URL(import.meta.url).search
+const load = (path) => import(new URL(`${path}${version}`, import.meta.url).href)
+const [starter, bootstrap] = await Promise.all([
+    load('./architecture-starter.mjs'),
+    load('./architecture-bootstrap.mjs'),
 ])
+const {createArchitectureStarter, PROVISIONAL_BUDGETS} = starter
+export const tBootstrapArchitecture = bootstrap.tBootstrapArchitecture
 
 const remediation = () => ({
     offlinePath: '.weavatrix/architecture.json',
@@ -41,62 +34,9 @@ function activeContract(ctx) {
     return loadArchitectureContract(ctx.repoRoot, ctx.graphPath)
 }
 
-const codeExtension = (file) => {
-    const name = String(file || '').split('/').at(-1) || ''
-    const dot = name.lastIndexOf('.')
-    return dot >= 0 ? name.slice(dot).toLowerCase() : ''
-}
-
-function starterContract(g, repoRoot) {
-    const classifier = createPathClassifier(repoRoot)
-    const files = [...new Set((g?.nodes || [])
-        .filter((node) => !String(node.id).includes('#'))
-        .map((node) => String(node.source_file || node.id || '').replace(/\\/g, '/'))
-        .filter((file) => file && PRODUCT_CODE_EXTENSIONS.has(codeExtension(file))))]
-        .filter((file) => {
-            const explanation = classifier.explain(file)
-            return !explanation.excluded && !hasPathClass(
-                explanation, 'test', 'e2e', 'generated', 'mock', 'story', 'docs', 'benchmark', 'temp',
-            )
-        })
-    const groups = new Map()
-    for (const file of files) {
-        const parts = file.split('/').filter(Boolean)
-        let key, name, path
-        if (parts.length === 1) {
-            key = 'root-code'
-            name = 'root code'
-            path = file
-        } else if (SOURCE_ROOTS.has(parts[0]) && parts.length === 2) {
-            key = `${parts[0]}-root`
-            name = `${parts[0]} (root files)`
-            path = file
-        } else {
-            path = parts.slice(0, SOURCE_ROOTS.has(parts[0]) ? 2 : 1).join('/')
-            key = path
-            name = path
-        }
-        const group = groups.get(key) || {name, paths: new Set(), files: 0}
-        group.paths.add(path)
-        group.files += 1
-        groups.set(key, group)
-    }
-    const components = [...groups].sort((a, b) => b[1].files - a[1].files || a[0].localeCompare(b[0])).slice(0, 80)
-        .map(([key, group], index) => ({
-            id: key.toLowerCase().replace(/[^a-z0-9._:-]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 100) || `component-${index + 1}`,
-            name: group.name,
-            paths: [...group.paths].sort((a, b) => a.localeCompare(b)),
-        }))
-    return normalizeArchitectureContract({
-        name: 'Proposed no-regressions baseline', style: 'custom', enforcement: 'ratchet', components,
-        dependencyRules: [],
-        budgets: PROVISIONAL_BUDGETS,
-        technologies: {required: [], forbidden: []}, exceptions: [], ratchet: {baseline: {fingerprints: [], metrics: {}}},
-    })
-}
-
 function notConfiguredResult(g, action, {includeStarter = false, repoRoot = null} = {}) {
-    const starter = includeStarter ? starterContract(g, repoRoot) : null
+    const proposal = includeStarter ? createArchitectureStarter(g, repoRoot) : null
+    const starter = proposal?.contract || null
     const starterText = starter
         ? ` A source-free starter with ${starter.components.length} product-code territories is available in JSON output from this lookup.`
         : ''
@@ -107,8 +47,15 @@ function notConfiguredResult(g, action, {includeStarter = false, repoRoot = null
         state: 'NOT_CONFIGURED',
         remediation: remediation(),
         ...(starter ? {
-            starterSummary: {components: starter.components.length, budgets: starter.budgets},
+            starterSummary: {
+                components: starter.components.length, budgets: starter.budgets,
+                observedDependencyDirections: proposal.observedDependencyProposals.length,
+                candidateBudgetsNotEnforced: proposal.budgetProposals.length,
+            },
             starterContract: starter,
+            observedDependencyProposals: proposal.observedDependencyProposals,
+            budgetProposals: proposal.budgetProposals,
+            starterMethodology: proposal.methodology,
         } : {}),
     })
 }
@@ -150,6 +97,7 @@ function provisionalPreflight(g, args, ctx) {
 }
 
 export function tGetArchitectureContract(g, args, ctx) {
+    if (args?.action === 'preview' || args?.action === 'approve') return tBootstrapArchitecture(g, args, ctx)
     const loaded = activeContract(ctx)
     if (!loaded.contract) {
         const text = loaded.error