@ttsc/graph 0.16.5 → 0.16.6

package/lib/server/runExpand.js

@@ -1,177 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runExpand = runExpand;
-exports.signatureOf = signatureOf;
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const resolveHandle_1 = require("./resolveHandle");
-// A whole declaration body can be large, so the full source is opt-in and capped
-// when asked for; the default response carries only the declared shape.
-const MAX_SOURCE_LINES = 200;
-// A signature is the declaration head up to the body brace — a handful of lines.
-const MAX_SIGNATURE_LINES = 6;
-// Neighbor lists are a map, not a dump; keep them scannable.
-const MAX_NEIGHBORS = 40;
-// A container's outline can be long (a big class); keep it bounded.
-const MAX_MEMBERS = 80;
-// Structural relationships are navigation, not the dependency picture expand is for.
-const STRUCTURAL_KINDS = new Set(["contains", "exports", "imports"]);
-// Kinds whose value is their member outline, not a source body.
-const CONTAINER_KINDS = new Set([
-    "class",
-    "interface",
-    "namespace",
-    "module",
-    "enum",
-    "file",
-]);
-/**
- * Resolve each handle to its declared shape — its signature, and for a
- * container the outline of its members — and, only when asked, its full source
- * body. This is the graph's edge over a plain file read: it answers from the
- * resolved structure it already holds, so the agent reads compact shape, not
- * inlined code, unless it explicitly needs a body's logic.
- */
-function runExpand(graph, props) {
-    const wantSource = props.source === true;
-    const nodes = [];
-    const unknown = [];
-    for (const handle of props.handles) {
-        const resolved = (0, resolveHandle_1.resolveGraphHandle)(graph, handle);
-        if (resolved.node === undefined) {
-            unknown.push(handle);
-            continue;
-        }
-        const node = resolved.node;
-        const expanded = {
-            id: node.id,
-            name: node.qualifiedName ?? node.name,
-            kind: node.kind,
-            file: node.file,
-        };
-        if (node.evidence?.startLine)
-            expanded.line = node.evidence.startLine;
-        const sig = signatureOf(graph.project, node);
-        if (sig !== undefined)
-            expanded.signature = sig;
-        if (CONTAINER_KINDS.has(node.kind)) {
-            const list = members(graph, node);
-            if (list.length > 0)
-                expanded.members = list;
-        }
-        if (wantSource) {
-            const source = readSource(graph.project, node);
-            if (source !== undefined) {
-                expanded.source = source.text;
-                if (source.truncated)
-                    expanded.truncated = true;
-            }
-        }
-        if (props.neighbors === true) {
-            expanded.dependsOn = refs(graph, graph.outgoing(node.id), "to");
-            expanded.dependedOnBy = refs(graph, graph.incoming(node.id), "from");
-        }
-        nodes.push(expanded);
-    }
-    return { nodes, unknown };
-}
-/** The members a container owns (via `contains`), each with its own signature. */
-function members(graph, node) {
-    const out = [];
-    for (const edge of graph.outgoing(node.id)) {
-        if (edge.kind !== "contains")
-            continue;
-        const member = graph.node(edge.to);
-        if (member === undefined)
-            continue;
-        const m = {
-            name: member.qualifiedName ?? member.name,
-            kind: member.kind,
-        };
-        if (member.evidence?.startLine)
-            m.line = member.evidence.startLine;
-        const sig = signatureOf(graph.project, member);
-        if (sig !== undefined)
-            m.signature = sig;
-        out.push(m);
-        if (out.length >= MAX_MEMBERS)
-            break;
-    }
-    return out;
-}
-/** Map dependency edges to references on their far endpoint, dropping structure. */
-function refs(graph, edges, end) {
-    const out = [];
-    for (const edge of edges) {
-        if (STRUCTURAL_KINDS.has(edge.kind))
-            continue;
-        const other = graph.node(end === "to" ? edge.to : edge.from);
-        if (other === undefined)
-            continue;
-        out.push({
-            id: other.id,
-            name: other.qualifiedName ?? other.name,
-            kind: other.kind,
-            relation: edge.kind,
-        });
-        if (out.length >= MAX_NEIGHBORS)
-            break;
-    }
-    return out;
-}
-/** Read a file's lines once, or undefined when it cannot be read. */
-function fileLines(project, node) {
-    if (node.evidence === undefined || node.file === "")
-        return undefined;
-    try {
-        return node_fs_1.default
-            .readFileSync(node_path_1.default.join(project, node.file), "utf8")
-            .split(/\r?\n/);
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * The declaration signature: the head of the declaration up to and including
- * the line that opens its body (`{`), or the single declaration line when there
- * is no brace, capped so a wrapped signature cannot run away.
- */
-function signatureOf(project, node) {
-    const lines = fileLines(project, node);
-    const evidence = node.evidence;
-    if (lines === undefined || evidence === undefined)
-        return undefined;
-    const start = Math.max(0, evidence.startLine - 1);
-    const out = [];
-    for (let i = start; i < lines.length && out.length < MAX_SIGNATURE_LINES; i++) {
-        const line = lines[i];
-        if (line === undefined)
-            break;
-        out.push(line);
-        if (line.includes("{"))
-            break;
-    }
-    const text = out.join("\n").trim();
-    return text === "" ? undefined : text;
-}
-/** Slice a node's full declaration source from disk, capped at MAX_SOURCE_LINES. */
-function readSource(project, node) {
-    const lines = fileLines(project, node);
-    const evidence = node.evidence;
-    if (lines === undefined || evidence === undefined)
-        return undefined;
-    const start = Math.max(0, evidence.startLine - 1);
-    const end = Math.min(evidence.endLine ?? evidence.startLine, lines.length);
-    let slice = lines.slice(start, Math.max(start + 1, end));
-    let truncated = false;
-    if (slice.length > MAX_SOURCE_LINES) {
-        slice = slice.slice(0, MAX_SOURCE_LINES);
-        truncated = true;
-    }
-    return { text: slice.join("\n"), truncated };
-}
-//# sourceMappingURL=runExpand.js.map

package/lib/server/runExpand.js.map

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

package/lib/server/runIndex.js.map

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

package/lib/server/runQuery.js.map

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

package/lib/structures/ITtscGraphExpand.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ITtscGraphExpand.js","sourceRoot":"","sources":["../../src/structures/ITtscGraphExpand.ts"],"names":[],"mappings":""}

package/lib/structures/ITtscGraphIndex.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ITtscGraphIndex.js","sourceRoot":"","sources":["../../src/structures/ITtscGraphIndex.ts"],"names":[],"mappings":""}

package/lib/structures/ITtscGraphQuery.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ITtscGraphQuery.js","sourceRoot":"","sources":["../../src/structures/ITtscGraphQuery.ts"],"names":[],"mappings":""}

package/src/server/runExpand.ts

@@ -1,186 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-
-import { TtscGraphMemory } from "../model/TtscGraphMemory";
-import { ITtscGraphEdge } from "../structures/ITtscGraphEdge";
-import { ITtscGraphExpand } from "../structures/ITtscGraphExpand";
-import { ITtscGraphNode } from "../structures/ITtscGraphNode";
-import { resolveGraphHandle } from "./resolveHandle";
-
-// A whole declaration body can be large, so the full source is opt-in and capped
-// when asked for; the default response carries only the declared shape.
-const MAX_SOURCE_LINES = 200;
-// A signature is the declaration head up to the body brace — a handful of lines.
-const MAX_SIGNATURE_LINES = 6;
-// Neighbor lists are a map, not a dump; keep them scannable.
-const MAX_NEIGHBORS = 40;
-// A container's outline can be long (a big class); keep it bounded.
-const MAX_MEMBERS = 80;
-// Structural relationships are navigation, not the dependency picture expand is for.
-const STRUCTURAL_KINDS = new Set<string>(["contains", "exports", "imports"]);
-// Kinds whose value is their member outline, not a source body.
-const CONTAINER_KINDS = new Set<string>([
-  "class",
-  "interface",
-  "namespace",
-  "module",
-  "enum",
-  "file",
-]);
-
-/**
- * Resolve each handle to its declared shape — its signature, and for a
- * container the outline of its members — and, only when asked, its full source
- * body. This is the graph's edge over a plain file read: it answers from the
- * resolved structure it already holds, so the agent reads compact shape, not
- * inlined code, unless it explicitly needs a body's logic.
- */
-export function runExpand(
-  graph: TtscGraphMemory,
-  props: ITtscGraphExpand.IProps,
-): ITtscGraphExpand {
-  const wantSource = props.source === true;
-  const nodes: ITtscGraphExpand.INode[] = [];
-  const unknown: string[] = [];
-  for (const handle of props.handles) {
-    const resolved = resolveGraphHandle(graph, handle);
-    if (resolved.node === undefined) {
-      unknown.push(handle);
-      continue;
-    }
-    const node = resolved.node;
-    const expanded: ITtscGraphExpand.INode = {
-      id: node.id,
-      name: node.qualifiedName ?? node.name,
-      kind: node.kind,
-      file: node.file,
-    };
-    if (node.evidence?.startLine) expanded.line = node.evidence.startLine;
-    const sig = signatureOf(graph.project, node);
-    if (sig !== undefined) expanded.signature = sig;
-    if (CONTAINER_KINDS.has(node.kind)) {
-      const list = members(graph, node);
-      if (list.length > 0) expanded.members = list;
-    }
-    if (wantSource) {
-      const source = readSource(graph.project, node);
-      if (source !== undefined) {
-        expanded.source = source.text;
-        if (source.truncated) expanded.truncated = true;
-      }
-    }
-    if (props.neighbors === true) {
-      expanded.dependsOn = refs(graph, graph.outgoing(node.id), "to");
-      expanded.dependedOnBy = refs(graph, graph.incoming(node.id), "from");
-    }
-    nodes.push(expanded);
-  }
-  return { nodes, unknown };
-}
-
-/** The members a container owns (via `contains`), each with its own signature. */
-function members(
-  graph: TtscGraphMemory,
-  node: ITtscGraphNode,
-): ITtscGraphExpand.IMember[] {
-  const out: ITtscGraphExpand.IMember[] = [];
-  for (const edge of graph.outgoing(node.id)) {
-    if (edge.kind !== "contains") continue;
-    const member = graph.node(edge.to);
-    if (member === undefined) continue;
-    const m: ITtscGraphExpand.IMember = {
-      name: member.qualifiedName ?? member.name,
-      kind: member.kind,
-    };
-    if (member.evidence?.startLine) m.line = member.evidence.startLine;
-    const sig = signatureOf(graph.project, member);
-    if (sig !== undefined) m.signature = sig;
-    out.push(m);
-    if (out.length >= MAX_MEMBERS) break;
-  }
-  return out;
-}
-
-/** Map dependency edges to references on their far endpoint, dropping structure. */
-function refs(
-  graph: TtscGraphMemory,
-  edges: readonly ITtscGraphEdge[],
-  end: "to" | "from",
-): ITtscGraphExpand.IReference[] {
-  const out: ITtscGraphExpand.IReference[] = [];
-  for (const edge of edges) {
-    if (STRUCTURAL_KINDS.has(edge.kind)) continue;
-    const other = graph.node(end === "to" ? edge.to : edge.from);
-    if (other === undefined) continue;
-    out.push({
-      id: other.id,
-      name: other.qualifiedName ?? other.name,
-      kind: other.kind,
-      relation: edge.kind,
-    });
-    if (out.length >= MAX_NEIGHBORS) break;
-  }
-  return out;
-}
-
-/** Read a file's lines once, or undefined when it cannot be read. */
-function fileLines(
-  project: string,
-  node: ITtscGraphNode,
-): string[] | undefined {
-  if (node.evidence === undefined || node.file === "") return undefined;
-  try {
-    return fs
-      .readFileSync(path.join(project, node.file), "utf8")
-      .split(/\r?\n/);
-  } catch {
-    return undefined;
-  }
-}
-
-/**
- * The declaration signature: the head of the declaration up to and including
- * the line that opens its body (`{`), or the single declaration line when there
- * is no brace, capped so a wrapped signature cannot run away.
- */
-export function signatureOf(
-  project: string,
-  node: ITtscGraphNode,
-): string | undefined {
-  const lines = fileLines(project, node);
-  const evidence = node.evidence;
-  if (lines === undefined || evidence === undefined) return undefined;
-  const start = Math.max(0, evidence.startLine - 1);
-  const out: string[] = [];
-  for (
-    let i = start;
-    i < lines.length && out.length < MAX_SIGNATURE_LINES;
-    i++
-  ) {
-    const line = lines[i];
-    if (line === undefined) break;
-    out.push(line);
-    if (line.includes("{")) break;
-  }
-  const text = out.join("\n").trim();
-  return text === "" ? undefined : text;
-}
-
-/** Slice a node's full declaration source from disk, capped at MAX_SOURCE_LINES. */
-function readSource(
-  project: string,
-  node: ITtscGraphNode,
-): { text: string; truncated: boolean } | undefined {
-  const lines = fileLines(project, node);
-  const evidence = node.evidence;
-  if (lines === undefined || evidence === undefined) return undefined;
-  const start = Math.max(0, evidence.startLine - 1);
-  const end = Math.min(evidence.endLine ?? evidence.startLine, lines.length);
-  let slice = lines.slice(start, Math.max(start + 1, end));
-  let truncated = false;
-  if (slice.length > MAX_SOURCE_LINES) {
-    slice = slice.slice(0, MAX_SOURCE_LINES);
-    truncated = true;
-  }
-  return { text: slice.join("\n"), truncated };
-}

package/src/structures/ITtscGraphExpand.ts

@@ -1,85 +0,0 @@
-/**
- * The resolved nodes the `graph_expand` tool returns for a set of handles —
- * their declared shape (signature, and a container's members), and only on
- * request their full source body.
- */
-export interface ITtscGraphExpand {
-  nodes: ITtscGraphExpand.INode[];
-
-  /** Handles that resolved to no node, or that were ambiguous. */
-  unknown: string[];
-}
-export namespace ITtscGraphExpand {
-  /** Which handles to expand, and how much of each to return. */
-  export interface IProps {
-    /**
-     * Node ids from another tool, or dotted symbol handles such as
-     * `OrderService.create`. Pass every handle you need in one call.
-     */
-    handles: string[];
-
-    /**
-     * Also list each node's direct dependencies and dependents (the symbols it
-     * uses and the symbols that use it).
-     *
-     * @default false
-     */
-    neighbors?: boolean;
-
-    /**
-     * Return the full declaration source body too. Off by default: expand
-     * returns the declared shape — a symbol's signature, and a class/interface/
-     * namespace's member outline — which is what you usually need and a
-     * fraction of the tokens. Turn this on only for the few leaf functions or
-     * methods whose actual control-flow logic you must read.
-     *
-     * @default false
-     */
-    source?: boolean;
-  }
-
-  /** One expanded node: its declared shape, and on request its source. */
-  export interface INode {
-    id: string;
-    name: string;
-    kind: string;
-    file: string;
-    /** 1-based declaration line, when known. */
-    line?: number;
-    /** The declaration signature — its first line(s) up to the body. */
-    signature?: string;
-    /**
-     * For a class, interface, namespace, module, enum, or file: the symbols it
-     * contains, each with its own signature — the member outline a consumer
-     * reaches for, without the bodies.
-     */
-    members?: IMember[];
-    /** The full declaration source — only when `source` was requested. */
-    source?: string;
-    /** True when `source` was cut at the line cap. */
-    truncated?: boolean;
-    /** Symbols this node uses (outgoing dependency edges). */
-    dependsOn?: IReference[];
-    /** Symbols that use this node (incoming dependency edges). */
-    dependedOnBy?: IReference[];
-  }
-
-  /** One member of a container node, with its signature but not its body. */
-  export interface IMember {
-    name: string;
-    kind: string;
-    /** 1-based declaration line, when known. */
-    line?: number;
-    /** The member's declaration signature. */
-    signature?: string;
-  }
-
-  /** A dependency neighbor of an expanded node and the edge that links them. */
-  export interface IReference {
-    id: string;
-    name: string;
-    kind: string;
-    /** The edge kind connecting the two (`calls`, `type_ref`, …). */
-    relation: string;
-  }
-}

package/src/structures/ITtscGraphQuery.ts

@@ -1,49 +0,0 @@
-/** The ranked hits the `graph_query` tool returns for a natural code query. */
-export interface ITtscGraphQuery {
-  hits: ITtscGraphQuery.IHit[];
-
-  /** Follow-up handles for source or member details. */
-  next: ITtscGraphQuery.INext;
-}
-export namespace ITtscGraphQuery {
-  /** Find the symbols and clusters most relevant to a natural code query. */
-  export interface IProps {
-    /**
-     * What to find, in natural language and code vocabulary mixed freely — a
-     * symbol name, a dotted member (`OrderService.create`), or a phrase
-     * (`shopping order create`, `repository find relations`). Exact names are
-     * not required; subword and CamelCase matches rank too.
-     */
-    query: string;
-
-    /**
-     * Maximum hits to return.
-     *
-     * @default 12
-     */
-    limit?: number;
-  }
-
-  /** One ranked hit with a handle to follow via `graph_expand` or `graph_trace`. */
-  export interface IHit {
-    id: string;
-    name: string;
-    kind: string;
-    file: string;
-    /** 1-based declaration line, when known. */
-    line?: number;
-    /**
-     * The hit's declaration signature, so you can often answer without
-     * expanding.
-     */
-    signature?: string;
-    /** Relative relevance; higher is a better match. */
-    score: number;
-  }
-
-  /** Tool-call handles suggested by this index result. */
-  export interface INext {
-    /** Pass these ids to `graph_expand`, with `source: true` only when needed. */
-    expand: string[];
-  }
-}