@callidescope/graph 0.0.63 → 0.0.65

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## 0.0.65 (2026-11-04)
+
+### 🧱 Updated Dependencies
+
+- Updated callidescope-configuration to 0.0.66
+- Updated callidescope-core to 0.0.65
+
+## 0.0.64 (2026-11-04)
+
+### 🧱 Updated Dependencies
+
+- Updated callidescope-configuration to 0.0.65
+- Updated callidescope-core to 0.0.64
+
 ## 0.0.63 (2026-11-04)
 
 ### 🧱 Updated Dependencies

package/README.md

@@ -637,7 +637,7 @@ graph LR
 ### Project
 
 ![Lines of Code](https://img.shields.io/badge/Lines_of_Code-12294-22c55e?style=flat-square)
-![Repository Size](https://img.shields.io/badge/Repository_Size-405.29_kB-6b7280?style=flat-square)
+![Repository Size](https://img.shields.io/badge/Repository_Size-405.57_kB-6b7280?style=flat-square)
 ![Folders](https://img.shields.io/badge/Folders-12-4a4a4a?style=flat-square)
 ![Source Files](https://img.shields.io/badge/Source_Files-90-3178c6?style=flat-square)
 
@@ -825,16 +825,16 @@ graph LR
 ### Markdown
 
 ![Markdown Files](https://img.shields.io/badge/Markdown_Files-2-083fa1?style=flat-square)
-![Markdown Lines](https://img.shields.io/badge/Markdown_Lines-662-1f6feb?style=flat-square)
+![Markdown Lines](https://img.shields.io/badge/Markdown_Lines-676-1f6feb?style=flat-square)
 ![H1](https://img.shields.io/badge/H1-1-7c3aed?style=flat-square)
-![H2](https://img.shields.io/badge/H2-66-8b5cf6?style=flat-square)
-![H3](https://img.shields.io/badge/H3-78-a78bfa?style=flat-square)
+![H2](https://img.shields.io/badge/H2-68-8b5cf6?style=flat-square)
+![H3](https://img.shields.io/badge/H3-80-a78bfa?style=flat-square)
 ![H4](https://img.shields.io/badge/H4-0-c4b5fd?style=flat-square)
 ![H5](https://img.shields.io/badge/H5-0-ddd6fe?style=flat-square)
 ![H6](https://img.shields.io/badge/H6-0-ede9fe?style=flat-square)
-![Paragraphs](https://img.shields.io/badge/Paragraphs-170-64748b?style=flat-square)
-![Lists](https://img.shields.io/badge/Lists-72-16a34a?style=flat-square)
-![List Items](https://img.shields.io/badge/List_Items-150-22c55e?style=flat-square)
+![Paragraphs](https://img.shields.io/badge/Paragraphs-174-64748b?style=flat-square)
+![Lists](https://img.shields.io/badge/Lists-74-16a34a?style=flat-square)
+![List Items](https://img.shields.io/badge/List_Items-154-22c55e?style=flat-square)
 ![Task List Items](https://img.shields.io/badge/Task_List_Items-0-4ade80?style=flat-square)
 ![Tables](https://img.shields.io/badge/Tables-2-0284c7?style=flat-square)
 ![Table Rows](https://img.shields.io/badge/Table_Rows-10-0ea5e9?style=flat-square)
@@ -852,105 +852,105 @@ graph LR
 
 The words this project uses that the root glossary does not define, regenerated with `nx run callidescope-graph:coinagerie-check:write`.
 
-- **adjacency**:
-- **advice**:
-- **aliased**:
-- **ancestor**:
-- **anonymous**:
-- **arrow**:
-- **assemble**:
-- **assembly**:
-- **assignable**:
-- **assignment**:
-- **barrel**:
-- **breadth**:
-- **cach**:
-- **callable**:
-- **callee**:
-- **caller**:
-- **canonical**:
-- **carry**:
-- **claim**:
-- **classification**:
-- **classify**:
-- **clause**:
-- **closure**:
-- **combine**:
-- **condense**:
-- **construction**:
-- **cycle**:
-- **deepest**:
-- **derive**:
-- **destination**:
-- **diagnostic**:
-- **digit**:
-- **direct**:
-- **disambiguator**:
-- **doc**:
-- **dot**:
-- **downward**:
-- **dynamic**:
-- **element**:
-- **enclose**:
-- **enter**:
-- **es**:
-- **es2015**:
-- **es2022**:
-- **exceed**:
-- **flatten**:
-- **follow**:
-- **frame**:
-- **heritage**:
-- **hierarchy**:
-- **identity**:
-- **initializer**:
-- **iterable**:
-- **later**:
-- **leaf**:
-- **lifecycle**:
-- **lift**:
-- **low**:
-- **many**:
-- **measure**:
-- **measurement**:
-- **memo**:
-- **memoize**:
-- **modern**:
-- **neighbor**:
-- **nominal**:
-- **orphan**:
-- **ownership**:
-- **permissive**:
-- **posix**:
-- **promote**:
-- **question**:
-- **quiet**:
-- **readable**:
-- **realpath**:
-- **relabel**:
-- **reverse**:
-- **scan**:
-- **sensitive**:
-- **sibling**:
-- **site**:
-- **splice**:
-- **successor**:
-- **sy**:
-- **syntax**:
-- **tarjan**:
-- **through**:
-- **too**:
-- **trace**:
-- **transitive**:
-- **traversal**:
-- **traverse**:
-- **unrelated**:
-- **unresolved**:
-- **unwrap**:
-- **upward**:
-- **vendor**:
-- **verdict**:
-- **weak**:
-- **widest**:
+- **adjacency**: Caller-to-callee lookup that the depth engine walks neighbor by neighbor when tracing call stacks.
+- **advice**: Hint text appended to a refused callable address telling the user how to disambiguate a shared line.
+- **aliased**: Import alias that symbol resolution unwraps through the checker getAliasedSymbol call to reach the real declaration.
+- **ancestor**: Containing directory higher up the tree, used to assign each file to its nearest owning project root.
+- **anonymous**: Placeholder name given to callbacks and unnamed members, stored in ANONYMOUS_MEMBER_NAME for callable identity.
+- **arrow**: Function-expression callable whose name comes from its enclosing declaration, labeled arrow-property in the naming pass.
+- **assemble**: Builds the final graph result by combining callables, edges, and condensed components into one AssembledGraph.
+- **assembly**: Stage in the pipeline where GraphAssemblyService joins discovered callables and resolved edges into the output graph.
+- **assignable**: Type-checker test for whether a class can stand where another type is expected, used to find implementers.
+- **assignment**: Parent-node check via isPropertyAssignment and variable declarations that names an otherwise anonymous callable.
+- **barrel**: Re-export module whose forwarded declarations are not real implementations, classified separately during entry discovery.
+- **breadth**: Width of a call graph, counting distinct callees per frame and compared to the maximumBreadth limit.
+- **cach**: Shorthand fragment of cache, cached, and cacheKey, the memoized lookup stores that reuse class and path results.
+- **callable**: Function, method, or constructor declaration that the call graph tracks as a node, identified by CallableId.
+- **callee**: Declaration that a call site invokes, the target end of an edge in the call graph.
+- **caller**: Callable whose body contains a call site, the source end of an edge that calleeIdsByCaller indexes.
+- **canonical**: Normalized spelling of a file name, such as getCanonicalFileName in test host stubs that returns it unchanged.
+- **carry**: Pass a value along unchanged, such as a declared address keeping its disambiguator through resolution.
+- **claim**: Mark a callable as already rooted so later passes do not root it again, tracked by the claimed set.
+- **classification**: Pass that labels each discovered callable with its entry-point or naming kind during entries discovery.
+- **classify**: Assign one callable a kind by inspecting its declaration, the single-callable step inside classifyEveryCallable.
+- **clause**: Extends or implements list on a class declaration, read to link each class to its base types.
+- **closure**: Dependency set of projects a run reaches through imports, against which its measurement scope is judged.
+- **combine**: Merges child depth results into one parent measurement, the step that takes the deepest or widest branch.
+- **condense**: Collapse strongly connected cycle components into single nodes so the graph becomes acyclic for depth measurement.
+- **construction**: A new-expression call site that constructs an instance, counted as a call site even without parentheses.
+- **cycle**: Loop in the call graph where a callable reaches itself, closed rather than followed so traversal terminates.
+- **deepest**: Longest call stack from a root, the path measured against maximumDepth and reported as the stack depth.
+- **derive**: Compute one value from another rather than restate it, such as deriving the subclass index from base names.
+- **destination**: Project root holding a manifest that another project can depend on, refused as a dependency-closure target in scoped runs.
+- **diagnostic**: Compiler error or warning reported by TypeScript for a source file, surfaced as messages on a program build.
+- **digit**: Numeric-only character run, matched by DIGITS_ONLY_PATTERN to recognize a line-number disambiguator suffix.
+- **direct**: Immediate call relationship, one hop with no intermediate callable, as opposed to a transitive reach.
+- **disambiguator**: Trailing line-number suffix that separates two callables sharing one address, such as a line suffix after the name.
+- **doc**: Prose comment on a callable declaration, read through the type checker and shown in each stack frame.
+- **dot**: Fragment of dotDotDotToken, the rest-parameter marker read by SignaturesService when building parameter signatures.
+- **downward**: Traversal direction from a root toward its callees, the way buildDownwardStacks walks the graph.
+- **dynamic**: Call whose target cannot be known statically, recorded as the DYNAMIC_CALL constant with a dynamic-value reason.
+- **element**: Bracket-indexed call target such as obj with a key in brackets, recognized by isElementAccessExpression during symbol resolution.
+- **enclose**: Wrap a region in a boundary, such as the enclosing callable that a call site sits inside during traversal.
+- **enter**: Callable the lookup began from, which ordering places first within its strongly connected component.
+- **es**: Fragment of ECMAScript language-level names like ES2015 and ES2022, used when reading standard library files.
+- **es2015**: ECMAScript 2015 compiler target, passed as ts.ScriptTarget.ES2015 when a host reads legacy library files.
+- **es2022**: ECMAScript 2022 compiler target that the program compiler host and tests pass to read modern source files.
+- **exceed**: Flag set when a lookup finds more candidates than the limit, so the caller gives up instead of guessing.
+- **flatten**: Turn a TypeScript diagnostic nested message chain into one plain string via flattenDiagnosticMessageText.
+- **follow**: Step along one call edge to the next callable, as depth and breadth traversal visit each callee in turn.
+- **frame**: One entry on the iterative traversal stack, holding a callable and its position among its successors.
+- **heritage**: Inheritance relationship on a class, its extends and implements clauses, which links subclass to base.
+- **hierarchy**: Index of class inheritance that resolves interface members to concrete implementations, built by ClassesService.
+- **identity**: Key built from a callable file path, qualified name, and line, produced by CallableIdentityService.
+- **initializer**: Expression assigned to a variable or property declaration, so an arrow constant reads its real function body.
+- **iterable**: Lazily consumable sequence type, such as the Iterable of callable ids accepted by components assembly.
+- **later**: Subsequent pass or call that must reuse an earlier result, so it never roots or reads the same thing twice.
+- **leaf**: Callable with no outgoing callees, a terminal frame that ends a stack and is counted as its depth.
+- **lifecycle**: Framework hook method names like ngOnInit or constructor that the runtime calls, so they are treated as entry points.
+- **lift**: Propagate a child low link up to its parent during component search, the lifting step of Tarjan algorithm.
+- **low**: Tarjan per-node minimum index reachable through back edges, deciding which nodes close a component.
+- **many**: Plural case that gives up rather than guessing, such as TOO_MANY_IMPLEMENTATIONS when a lookup matches too broadly.
+- **measure**: Compute a depth or breadth figure over the call graph, the step that yields numbers a limit is judged against.
+- **measurement**: Result of measuring depth or breadth for a run, reported in the Measure table and compared against project limits.
+- **memo**: Shorthand fragment of memoize and memoized, the caching of class and verdict lookups.
+- **memoize**: Cache a function result per input so repeated lookups, such as per-source-file verdicts, skip recomputation.
+- **modern**: ECMAScript 2022 target used as the current-language fixture in compiler host tests, contrasted with legacy ES2015.
+- **neighbor**: Adjacent callable reached by one edge from the current frame, which is followed, closed, or skipped.
+- **nominal**: Class-name based match, preferred over structural checks when a base names its implementers directly.
+- **orphan**: Callable nothing calls and nothing roots, so it starts its own stack and shows as a root.
+- **ownership**: Rule deciding which project a file belongs to, so each callable is traced by exactly one owning program.
+- **permissive**: Filter that excludes nothing, used in tests to let every file through the file-filter contract.
+- **posix**: Forward-slash path form, produced by path.posix so workspace-relative addresses match on every platform.
+- **promote**: Move a callable into the roots or entry set, such as promoteOrphans lifting unexported declarations there.
+- **question**: Optional-marker token on a declaration, read as a QuestionToken to decide if a member may be absent.
+- **quiet**: Dropping something without reporting it, as a lookup that quietly finds nothing rather than failing.
+- **readable**: Quality the project constants and section layout aim for, so services stay clear to scan.
+- **realpath**: Symlink-resolved absolute file path, used so a file reached through a symlink is matched to its owning program.
+- **relabel**: Rename a file project label in tests, so a fixture can place the same file under another project name.
+- **reverse**: Flip a path order so a stack reads callee-first, applied with toReversed when a flag is set.
+- **scan**: Walk a directory tree or source file set to collect candidates, skipping excluded scan directory names.
+- **sensitive**: Qualifier on tests that depend on a fixed clock, which the shared mocks pin to one default date.
+- **sibling**: Directory at the same level as another one, which containment checks must never treat as inside it.
+- **site**: Location of a call expression in source, the call site that edges are resolved from.
+- **splice**: Remove a run of members from the pending stack once a component closes, taking everything from one index onward.
+- **successor**: Next callee of a frame still to visit, tracked by successorIndex so the traversal resumes where it left off.
+- **sy**: Fragment of a longer word such as symbol, sync, or syntax, not a term this project defines.
+- **syntax**: Shape of a TypeScript node, read through ts.SyntaxKind to tell calls, property accesses, and keywords apart.
+- **tarjan**: Strongly-connected-components algorithm by Tarjan, whose state the components service tracks per callable during cycle condensation.
+- **through**: Preposition marking a route that passes across an intermediate callable, such as traversal through adjacency.
+- **too**: Qualifier marking a limit crossed, as in TOO_MANY_IMPLEMENTATIONS when a class lookup is over-broad.
+- **trace**: Analyze a project code to build its call graph, starting from entry points and following each call site.
+- **transitive**: Reaching callees through intermediate hops, which breadth does not count, only direct callees.
+- **traversal**: Walk over the call graph from roots through successors, the process depth and breadth measurement perform.
+- **traverse**: Visit a graph node and its successors, the method that recursively walks every path from a start callable.
+- **unrelated**: Describes a class or callable with no connection to the one being looked up, so it is skipped as a candidate.
+- **unresolved**: Call site or address whose target could not be matched to a declaration, reported rather than silently dropped.
+- **unwrap**: Peel an import alias off to reach the symbol it names, in symbol resolution via unwrapAlias.
+- **upward**: Propagating a measurement toward callers, the direction a depth result moves when a candidate is followed.
+- **vendor**: Third-party code under node_modules, which is treated as external rather than traced into as project source.
+- **verdict**: Boolean decision whether a source file counts as external, memoized per file by the external service.
+- **weak**: Map keyed by object identity that drops entries when the source file is released, used for verdicts and checkers.
+- **widest**: Callable with the greatest fan-out, the point a run reports as its breadth maximum.
 
 <!-- coinagerie:end -->

package/package.json

@@ -4,8 +4,8 @@
     "url": "https://github.com/organizzolini/codebase/issues"
   },
   "dependencies": {
-    "@callidescope/configuration": "0.0.64",
-    "@callidescope/core": "0.0.63",
+    "@callidescope/configuration": "0.0.66",
+    "@callidescope/core": "0.0.65",
     "@nestjs/common": "^11.1.21 || ^12.0.1",
     "pino": "^10.3.1",
     "pino-pretty": "^13.1.3",
@@ -66,5 +66,5 @@
     "strict": true
   },
   "types": "./dist/src/index.d.ts",
-  "version": "0.0.63"
+  "version": "0.0.65"
 }