@monoes/monograph 1.1.0 → 1.2.1

package/dist/src/health/vital-signs.js

@@ -0,0 +1,37 @@
+// Extended vital-signs metric struct for project-wide trend tracking.
+// Extends the basic snapshot with interfacing risk, LOC, coverage model, coupling.
+export const VITAL_SIGNS_SCHEMA_VERSION = 7;
+export function createVitalSigns(partial) {
+    const now = new Date().toISOString();
+    return {
+        schemaVersion: VITAL_SIGNS_SCHEMA_VERSION,
+        createdAt: now,
+        healthScore: 0,
+        healthGrade: 'F',
+        counts: {
+            unusedExports: 0, deadFiles: 0, circularDeps: 0, boundaryViolations: 0,
+            cloneGroups: 0, duplicatedLinesPct: 0, highComplexityFunctions: 0,
+        },
+        sizeRisk: { smallPct: 0, mediumPct: 0, largePct: 0, xlargePct: 0 },
+        interfacingRisk: { lowParamPct: 0, mediumParamPct: 0, highParamPct: 0, xlParamPct: 0 },
+        fanIn95th: 0,
+        couplingConcentrationPct: 0,
+        totalLoc: 0,
+        totalFiles: 0,
+        totalNodes: 0,
+        totalEdges: 0,
+        coverageModel: 'none',
+        ...partial,
+    };
+}
+export function formatVitalSignsSummary(vs) {
+    return [
+        `Health: ${vs.healthGrade} (${vs.healthScore.toFixed(1)}/100)`,
+        `Files: ${vs.totalFiles}  LOC: ${vs.totalLoc}  Nodes: ${vs.totalNodes}`,
+        `Unused exports: ${vs.counts.unusedExports}  Dead files: ${vs.counts.deadFiles}`,
+        `Duplication: ${vs.counts.duplicatedLinesPct.toFixed(1)}%  Clones: ${vs.counts.cloneGroups}`,
+        `Circular deps: ${vs.counts.circularDeps}  Boundary violations: ${vs.counts.boundaryViolations}`,
+        `Coverage model: ${vs.coverageModel}`,
+    ].join('\n');
+}
+//# sourceMappingURL=vital-signs.js.map

package/dist/src/health/vital-signs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vital-signs.js","sourceRoot":"","sources":["../../../src/health/vital-signs.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,mFAAmF;AAEnF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAgE5C,MAAM,UAAU,gBAAgB,CAAC,OAA8D;IAC7F,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO;QACL,aAAa,EAAE,0BAA0B;QACzC,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,GAAG;QAChB,MAAM,EAAE;YACN,aAAa,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC;YACtE,WAAW,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,uBAAuB,EAAE,CAAC;SAClE;QACD,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;QAClE,eAAe,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE;QACtF,SAAS,EAAE,CAAC;QACZ,wBAAwB,EAAE,CAAC;QAC3B,QAAQ,EAAE,CAAC;QACX,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;QACb,aAAa,EAAE,MAAM;QACrB,GAAG,OAAO;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,EAAc;IACpD,OAAO;QACL,WAAW,EAAE,CAAC,WAAW,KAAK,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;QAC9D,UAAU,EAAE,CAAC,UAAU,UAAU,EAAE,CAAC,QAAQ,YAAY,EAAE,CAAC,UAAU,EAAE;QACvE,mBAAmB,EAAE,CAAC,MAAM,CAAC,aAAa,iBAAiB,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE;QAChF,gBAAgB,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE;QAC5F,kBAAkB,EAAE,CAAC,MAAM,CAAC,YAAY,0BAA0B,EAAE,CAAC,MAAM,CAAC,kBAAkB,EAAE;QAChG,mBAAmB,EAAE,CAAC,aAAa,EAAE;KACtC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/src/index.d.ts

@@ -9,10 +9,106 @@ export * from './pipeline/orchestrator.js';
 export * from './graph/loader.js';
 export * from './graph/analyzer.js';
 export * from './graph/diff.js';
+export * from './graph/dfs.js';
 export * from './watch/watcher.js';
 export * from './export/json.js';
 export * from './export/html.js';
 export * from './export/cypher.js';
 export * from './export/graphml.js';
 export * from './export/svg.js';
+export * from './mcp-tools/index.js';
+export * from './staleness/git-staleness.js';
+export * from './storage/embedding-store.js';
+export * from './search/rrf.js';
+export * from './search/embedder.js';
+export * from './search/embed-batch.js';
+export * from './search/hybrid-query.js';
+export * from './mcp-tools/embed.js';
+export * from './groups/group-config.js';
+export * from './groups/group-search.js';
+export * from './groups/contract-bridge.js';
+export * from './groups/contract-registry.js';
+export * from './groups/group-sync.js';
+export * from './mcp-tools/group-query.js';
+export * from './mcp-tools/group-list.js';
+export * from './mcp-tools/group-sync.js';
+export * from './wiki/prompt-builder.js';
+export * from './wiki/wiki-generator.js';
+export * from './wiki/gist-publisher.js';
+export * from './web/server.js';
+export * from './web/api.js';
+export * from './web/async-jobs.js';
+export * from './web/react-ui.js';
+export * from './web/analyze-api.js';
+export * from './web/mcp-http.js';
+export * from './mcp-resources/index.js';
+export * from './analysis/shape-extractor.js';
+export * from './mcp-tools/tool-map.js';
+export * from './mcp-tools/shape-check.js';
+export * from './mcp-tools/neighbors.js';
+export * from './mcp-tools/explain.js';
+export * from './security/sensitive-files.js';
+export * from './validation/extraction-validator.js';
+export * from './security/safe-fetch.js';
+export * from './cache/extraction-cache.js';
+export * from './pipeline/phases/variables.js';
+export * from './pipeline/cluster-only.js';
+export * from './pipeline/phases/field-access.js';
+export * from './pipeline/phases/wildcard-synthesis.js';
+export * from './cli/hooks-install.js';
+export * from './cli/augment.js';
+export * from './cli/setup.js';
+export * from './cli/ai-context.js';
+export * from './cli/doctor.js';
+export * from './cli/eval-server.js';
+export * from './cli/skill-gen.js';
+export * from './cli/check-update.js';
+export * from './skills/platform-skills.js';
+export * from './reporting/graph-report.js';
+export * from './analysis/surprise-scorer.js';
+export * from './analysis/file-classifier.js';
+export * from './pipeline/phases/evidence.js';
+export * from './registry/repo-registry.js';
+export * from './search/ast-chunker.js';
+export * from './search/http-embedder.js';
+export * from './search/device-config.js';
+export * from './wiki/providers.js';
+export * from './pipeline/phases/variables-phase.js';
+export * from './pipeline/phases/wildcard-phase.js';
+export * from './pipeline/phases/framework-detect.js';
+export * from './pipeline/phases/import-resolver.js';
+export * from './analysis/benchmark.js';
+export * from './analysis/cluster-quality.js';
+export * from './analysis/node-similarity.js';
+export * from './graph/ripple-impact.js';
+export * from './analysis/dependency-health.js';
+export * from './parsers/named-bindings.js';
+export * from './parsers/language-parsers.js';
+export * from './cache/augment-cache.js';
+export * from './scope-resolution/evidence-weights.js';
+export * from './export/csv.js';
+export * from './mcp-tools/list-repos.js';
+export * from './mcp-tools/query.js';
+export * from './search/diacritic.js';
+export * from './ingest/url-ingest.js';
+export * from './analysis/corpus-health.js';
+export * from './search/exact-search.js';
+export * from './groups/grpc-extractor.js';
+export * from './groups/topic-extractor.js';
+export * from './groups/service-boundary.js';
+export * from './graph/topo-sort.js';
+export * from './graph/wcc.js';
+export * from './graph/pagerank.js';
+export * from './graph/dead-code.js';
+export * from './graph/import-chain.js';
+export * from './graph/cycles.js';
+export * from './graph/edge-filter.js';
+export * from './graph/node-search.js';
+export * from './graph/merge.js';
+export * from './graph/regex-search.js';
+export * from './graph/normalize-id.js';
+export * from './export/adjacency-matrix.js';
+export * from './ingest/query-memory.js';
+export * from './ingest/git-clone.js';
+export * from './ingest/transcribe.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/index.js

@@ -9,10 +9,108 @@ export * from './pipeline/orchestrator.js';
 export * from './graph/loader.js';
 export * from './graph/analyzer.js';
 export * from './graph/diff.js';
+export * from './graph/dfs.js';
 export * from './watch/watcher.js';
 export * from './export/json.js';
 export * from './export/html.js';
 export * from './export/cypher.js';
 export * from './export/graphml.js';
 export * from './export/svg.js';
+export * from './mcp-tools/index.js';
+export * from './staleness/git-staleness.js';
+export * from './storage/embedding-store.js';
+export * from './search/rrf.js';
+export * from './search/embedder.js';
+export * from './search/embed-batch.js';
+export * from './search/hybrid-query.js';
+export * from './mcp-tools/embed.js';
+export * from './groups/group-config.js';
+export * from './groups/group-search.js';
+export * from './groups/contract-bridge.js';
+export * from './groups/contract-registry.js';
+export * from './groups/group-sync.js';
+export * from './mcp-tools/group-query.js';
+export * from './mcp-tools/group-list.js';
+export * from './mcp-tools/group-sync.js';
+// wiki/wiki-store.js intentionally not re-exported: its WikiPage conflicts with mcp-tools/wiki.ts's WikiPage
+export * from './wiki/prompt-builder.js';
+export * from './wiki/wiki-generator.js';
+export * from './wiki/gist-publisher.js';
+export * from './web/server.js';
+export * from './web/api.js';
+export * from './web/async-jobs.js';
+export * from './web/react-ui.js';
+export * from './web/analyze-api.js';
+export * from './web/mcp-http.js';
+export * from './mcp-resources/index.js';
+export * from './analysis/shape-extractor.js';
+export * from './mcp-tools/tool-map.js';
+export * from './mcp-tools/shape-check.js';
+export * from './mcp-tools/neighbors.js';
+// mcp-tools/graph-query.js re-exported via mcp-tools/index.js to avoid queryGraph duplicate
+export * from './mcp-tools/explain.js';
+export * from './security/sensitive-files.js';
+export * from './validation/extraction-validator.js';
+export * from './security/safe-fetch.js';
+export * from './cache/extraction-cache.js';
+export * from './pipeline/phases/variables.js';
+export * from './pipeline/cluster-only.js';
+export * from './pipeline/phases/field-access.js';
+export * from './pipeline/phases/wildcard-synthesis.js';
+export * from './cli/hooks-install.js';
+export * from './cli/augment.js';
+export * from './cli/setup.js';
+export * from './cli/ai-context.js';
+export * from './cli/doctor.js';
+export * from './cli/eval-server.js';
+export * from './cli/skill-gen.js';
+export * from './cli/check-update.js';
+export * from './skills/platform-skills.js';
+export * from './reporting/graph-report.js';
+export * from './analysis/surprise-scorer.js';
+export * from './analysis/file-classifier.js';
+export * from './pipeline/phases/evidence.js';
+export * from './registry/repo-registry.js';
+export * from './search/ast-chunker.js';
+export * from './search/http-embedder.js';
+export * from './search/device-config.js';
+export * from './wiki/providers.js';
+export * from './pipeline/phases/variables-phase.js';
+export * from './pipeline/phases/wildcard-phase.js';
+export * from './pipeline/phases/framework-detect.js';
+export * from './pipeline/phases/import-resolver.js';
+export * from './analysis/benchmark.js';
+export * from './analysis/cluster-quality.js';
+export * from './analysis/node-similarity.js';
+export * from './graph/ripple-impact.js';
+export * from './analysis/dependency-health.js';
+export * from './parsers/named-bindings.js';
+export * from './parsers/language-parsers.js';
+export * from './cache/augment-cache.js';
+export * from './scope-resolution/evidence-weights.js';
+export * from './export/csv.js';
+export * from './mcp-tools/list-repos.js';
+export * from './mcp-tools/query.js';
+export * from './search/diacritic.js';
+export * from './ingest/url-ingest.js';
+export * from './analysis/corpus-health.js';
+export * from './search/exact-search.js';
+export * from './groups/grpc-extractor.js';
+export * from './groups/topic-extractor.js';
+export * from './groups/service-boundary.js';
+export * from './graph/topo-sort.js';
+export * from './graph/wcc.js';
+export * from './graph/pagerank.js';
+export * from './graph/dead-code.js';
+export * from './graph/import-chain.js';
+export * from './graph/cycles.js';
+export * from './graph/edge-filter.js';
+export * from './graph/node-search.js';
+export * from './graph/merge.js';
+export * from './graph/regex-search.js';
+export * from './graph/normalize-id.js';
+export * from './export/adjacency-matrix.js';
+export * from './ingest/query-memory.js';
+export * from './ingest/git-clone.js';
+export * from './ingest/transcribe.js';
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/ingest/git-clone.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Git Clone Utility with SSRF Protection
+ *
+ * Shallow-clones repositories into ~/.monograph/repos/{name}/.
+ * If already cloned, runs `git pull --ff-only` instead.
+ *
+ * SSRF protection: only https:// and http:// are allowed,
+ * and private/internal IP ranges are blocked.
+ */
+/**
+ * Validate a git URL to prevent SSRF attacks.
+ *
+ * Blocks:
+ * - Non-http(s) schemes
+ * - Private IPv4 ranges (127.x, 10.x, 172.16-31.x, 192.168.x, 169.254.x, etc.)
+ * - IPv6 private ranges (::1, fc00::/7, fe80::/10, ::ffff:...)
+ * - Cloud metadata hostnames
+ * - Numeric IP encodings (decimal/hex)
+ *
+ * @throws {Error} with a descriptive message if the URL is not safe.
+ */
+export declare function validateGitUrl(url: string): void;
+/**
+ * Extract the repository name from an HTTPS or SSH git URL.
+ *
+ * @example
+ * extractRepoName('https://github.com/org/repo.git') // 'repo'
+ * extractRepoName('git@github.com:org/repo.git')     // 'repo'
+ */
+export declare function extractRepoName(url: string): string;
+/**
+ * Get the default clone target directory for a repository name.
+ * Repositories are stored in `~/.monograph/repos/{repoName}`.
+ */
+export declare function getCloneDir(repoName: string): string;
+export interface CloneProgress {
+    phase: 'cloning' | 'pulling';
+    message: string;
+}
+/**
+ * Clone or pull a git repository with SSRF protection.
+ *
+ * - If `targetDir/.git` does not exist: `git clone --depth 1 <url> <targetDir>`
+ * - If `targetDir/.git` exists: `git pull --ff-only`
+ *
+ * The URL is validated against SSRF rules before any network operation.
+ *
+ * @param url       - The git remote URL (must be https:// or http://).
+ * @param targetDir - Local directory to clone into.
+ * @param onProgress - Optional progress callback.
+ * @returns Resolves to `targetDir` on success.
+ */
+export declare function cloneOrPull(url: string, targetDir: string, onProgress?: (progress: CloneProgress) => void): Promise<string>;
+//# sourceMappingURL=git-clone.d.ts.map

package/dist/src/ingest/git-clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-clone.d.ts","sourceRoot":"","sources":["../../../src/ingest/git-clone.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAwDhD;AA8CD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASnD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAID,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,GAC7C,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/dist/src/ingest/git-clone.js

@@ -0,0 +1,204 @@
+/**
+ * Git Clone Utility with SSRF Protection
+ *
+ * Shallow-clones repositories into ~/.monograph/repos/{name}/.
+ * If already cloned, runs `git pull --ff-only` instead.
+ *
+ * SSRF protection: only https:// and http:// are allowed,
+ * and private/internal IP ranges are blocked.
+ */
+import { spawn } from 'child_process';
+import path from 'path';
+import os from 'os';
+import fs from 'fs/promises';
+import { isIP } from 'net';
+// ── SSRF validation ───────────────────────────────────────────────────────────
+const BLOCKED_HOSTNAMES = new Set([
+    'localhost',
+    'metadata.google.internal',
+    'metadata.azure.com',
+    'metadata.internal',
+    'metadata.goog',
+]);
+/**
+ * Validate a git URL to prevent SSRF attacks.
+ *
+ * Blocks:
+ * - Non-http(s) schemes
+ * - Private IPv4 ranges (127.x, 10.x, 172.16-31.x, 192.168.x, 169.254.x, etc.)
+ * - IPv6 private ranges (::1, fc00::/7, fe80::/10, ::ffff:...)
+ * - Cloud metadata hostnames
+ * - Numeric IP encodings (decimal/hex)
+ *
+ * @throws {Error} with a descriptive message if the URL is not safe.
+ */
+export function validateGitUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new Error('Invalid URL');
+    }
+    if (!['https:', 'http:'].includes(parsed.protocol)) {
+        throw new Error('Only https:// and http:// git URLs are allowed');
+    }
+    const host = parsed.hostname.toLowerCase();
+    if (BLOCKED_HOSTNAMES.has(host)) {
+        throw new Error('Cloning from private/internal addresses is not allowed');
+    }
+    // Strip IPv6 brackets
+    let normalizedHost = host;
+    if (host.startsWith('[') && host.endsWith(']')) {
+        normalizedHost = host.slice(1, -1);
+    }
+    // Detect IPv6
+    const isIPv6 = isIP(normalizedHost) === 6 || normalizedHost.includes(':');
+    if (isIPv6) {
+        assertNotPrivateIPv6(normalizedHost);
+        return;
+    }
+    // Detect IPv4
+    if (isIP(normalizedHost) === 4) {
+        assertNotPrivateIPv4(normalizedHost);
+        return;
+    }
+    // Block numeric IP encodings (decimal: 2130706433, hex: 0x7f000001)
+    if (/^\d+$/.test(host) || /^0x[0-9a-f]+$/i.test(host)) {
+        throw new Error('Cloning from private/internal addresses is not allowed');
+    }
+    // Standard IPv4 dotted-notation private checks
+    if (/^127\./.test(host) ||
+        /^10\./.test(host) ||
+        /^172\.(1[6-9]|2\d|3[01])\./.test(host) ||
+        /^192\.168\./.test(host) ||
+        /^169\.254\./.test(host) ||
+        /^0\./.test(host) ||
+        host === '0.0.0.0' ||
+        /^100\.(6[4-9]|[7-9]\d|1[01]\d|12[0-7])\./.test(host) ||
+        /^198\.1[89]\./.test(host)) {
+        throw new Error('Cloning from private/internal addresses is not allowed');
+    }
+}
+function assertNotPrivateIPv6(ip) {
+    const lower = ip.toLowerCase();
+    if (lower === '::1' || lower === '0:0:0:0:0:0:0:1') {
+        throw new Error('Cloning from private/internal addresses is not allowed');
+    }
+    if (lower === '::' || lower === '0:0:0:0:0:0:0:0') {
+        throw new Error('Cloning from private/internal addresses is not allowed');
+    }
+    if (lower.startsWith('fc') || lower.startsWith('fd')) {
+        throw new Error('Cloning from private/internal addresses is not allowed');
+    }
+    if (lower.startsWith('fe80') ||
+        lower.startsWith('fe8') ||
+        lower.startsWith('fe9') ||
+        lower.startsWith('fea') ||
+        lower.startsWith('feb')) {
+        throw new Error('Cloning from private/internal addresses is not allowed');
+    }
+    if (lower.startsWith('::ffff:') || lower.includes(':ffff:')) {
+        throw new Error('Cloning from private/internal addresses is not allowed');
+    }
+}
+function assertNotPrivateIPv4(ip) {
+    const parts = ip.split('.').map(Number);
+    const [a, b] = parts;
+    if (a === 127 ||
+        a === 10 ||
+        (a === 172 && b >= 16 && b <= 31) ||
+        (a === 192 && b === 168) ||
+        (a === 169 && b === 254) ||
+        a === 0 ||
+        (a === 100 && b >= 64 && b <= 127) ||
+        (a === 198 && (b === 18 || b === 19))) {
+        throw new Error('Cloning from private/internal addresses is not allowed');
+    }
+}
+// ── URL helpers ────────────────────────────────────────────────────────────────
+/**
+ * Extract the repository name from an HTTPS or SSH git URL.
+ *
+ * @example
+ * extractRepoName('https://github.com/org/repo.git') // 'repo'
+ * extractRepoName('git@github.com:org/repo.git')     // 'repo'
+ */
+export function extractRepoName(url) {
+    const cleaned = url.replace(/\/+$/, '');
+    const lastSegment = cleaned.split(/[/:]/).pop() ?? 'unknown';
+    const name = lastSegment.replace(/\.git$/, '');
+    // Guard against path traversal: reject segments containing .. or path separators
+    if (!name || name.includes('..') || name.includes('/') || name.includes('\\')) {
+        return 'unknown-repo';
+    }
+    return name;
+}
+/**
+ * Get the default clone target directory for a repository name.
+ * Repositories are stored in `~/.monograph/repos/{repoName}`.
+ */
+export function getCloneDir(repoName) {
+    return path.join(os.homedir(), '.monograph', 'repos', repoName);
+}
+/**
+ * Clone or pull a git repository with SSRF protection.
+ *
+ * - If `targetDir/.git` does not exist: `git clone --depth 1 <url> <targetDir>`
+ * - If `targetDir/.git` exists: `git pull --ff-only`
+ *
+ * The URL is validated against SSRF rules before any network operation.
+ *
+ * @param url       - The git remote URL (must be https:// or http://).
+ * @param targetDir - Local directory to clone into.
+ * @param onProgress - Optional progress callback.
+ * @returns Resolves to `targetDir` on success.
+ */
+export async function cloneOrPull(url, targetDir, onProgress) {
+    // Always validate before any operation
+    validateGitUrl(url);
+    const hasGitDir = await fs.access(path.join(targetDir, '.git')).then(() => true, () => false);
+    if (hasGitDir) {
+        onProgress?.({ phase: 'pulling', message: 'Pulling latest changes…' });
+        await runGit(['pull', '--ff-only'], targetDir);
+    }
+    else {
+        await fs.mkdir(path.dirname(targetDir), { recursive: true });
+        onProgress?.({ phase: 'cloning', message: `Cloning ${url}…` });
+        await runGit(['clone', '--depth', '1', url, targetDir]);
+    }
+    return targetDir;
+}
+// ── git subprocess ─────────────────────────────────────────────────────────────
+function runGit(args, cwd) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn('git', args, {
+            cwd,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: {
+                ...process.env,
+                GIT_TERMINAL_PROMPT: '0',
+                GIT_ASKPASS: process.platform === 'win32' ? 'echo' : '/bin/true',
+            },
+        });
+        let stderr = '';
+        proc.stderr.on('data', (chunk) => {
+            stderr += chunk;
+        });
+        proc.on('close', code => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                if (stderr.trim()) {
+                    console.error(`git ${args[0]} stderr: ${stderr.trim()}`);
+                }
+                reject(new Error(`git ${args[0]} failed (exit code ${code})`));
+            }
+        });
+        proc.on('error', err => {
+            reject(new Error(`Failed to spawn git: ${err.message}`));
+        });
+    });
+}
+//# sourceMappingURL=git-clone.js.map

package/dist/src/ingest/git-clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-clone.js","sourceRoot":"","sources":["../../../src/ingest/git-clone.ts"],"names":[],"mappings":"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"}

package/dist/src/ingest/query-memory.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Q&A memory feedback loop.
+ *
+ * Mirrors graphify's `save_query_result`: saves question/answer pairs as
+ * Markdown files with YAML front-matter into a memory directory.  On the next
+ * rebuild those files are treated as document nodes, so the graph grows smarter
+ * from both what you add AND what you ask.
+ *
+ * Intended for use after `monographQuery` / `monographExplain` calls so that
+ * insights are persisted and available during future pipeline runs.
+ */
+export interface SaveQueryResultOptions {
+    /** Question / query string. */
+    question: string;
+    /** Answer produced by the graph query. */
+    answer: string;
+    /**
+     * Directory where memory files are written.
+     * Defaults to `<cwd>/monograph-out/memory`.
+     */
+    memoryDir?: string;
+    /** Free-form query type label (e.g. "query", "explain", "impact"). Default: "query". */
+    queryType?: string;
+    /**
+     * Up to 10 node ids / names that were the primary sources for the answer.
+     * These are stored in front-matter so a future extraction pass can wire up
+     * edges to the originating nodes.
+     */
+    sourceNodes?: string[];
+}
+export interface SaveQueryResultOutput {
+    /** Absolute path of the written Markdown file. */
+    filePath: string;
+    /** ISO-8601 timestamp of when the file was written. */
+    writtenAt: string;
+}
+/**
+ * Save a Q&A query result as a Markdown file in the memory directory.
+ *
+ * The file has YAML front-matter that monograph's document extractor reads
+ * as node metadata.  The body contains the question and answer in a
+ * human-readable format.
+ *
+ * @param options - Query options including question, answer, and target dir.
+ * @returns The file path and write timestamp.
+ */
+export declare function saveQueryResult(options: SaveQueryResultOptions): SaveQueryResultOutput;
+//# sourceMappingURL=query-memory.d.ts.map

package/dist/src/ingest/query-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-memory.d.ts","sourceRoot":"","sources":["../../../src/ingest/query-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;CACnB;AA0BD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CAqDtF"}