Execute ASSIS v0.9.3 Test Plan (assis-core)

[masmangan]

[masmangan]

6.4 Diagram Inspection
Minor plan deviation.

.puml is at:
INFO: Writing /Users/masmangan/assis-0-9-3-test/assis/assis-core/docs/diagrams/src/class-diagram.puml

masmangan@Marcos-iMac assis-core % plantuml --svg class-diagram.puml
open class-diagram.svg
No diagram found
The file /Users/masmangan/assis-0-9-3-test/assis/assis-core/class-diagram.svg does not exist.

Rewrite to:

plantuml --svg docs/diagrams/src/class-diagram.puml
open docs/diagrams/src/class-diagram.puml

v0.9.3 contain bug #37.
Fixing file by hand.

Adding } as in:
Before
/' @assis:end record "io.github.masmangan.assis.deps.UnresolvedTypeRef"'/
After
} /' @assis:end record "io.github.masmangan.assis.deps.UnresolvedTypeRef"'/
in each end type block.

SVG is ok.

Additional comments:

diagram shows depth package still under development and not connected to ASSIS execution.

GenerateClassDiagram is unconnected, because of it has only static methods and no dependencies are scanned at the moment, that is the subject of reps package.

Missing dependencies include declared type references:
pw : PlantUMLWriter as parameter
idx: DeclaredIndex

Other dependencies include external type references:
java.lang and java.util types, as java.util.List
Java Parser types, as TypeDeclaration

Possible need to refactor scan source with Java Parser responsibility from write diagram/traverse AST responsibility into two classes.

GenerateClassDiagram and PlantUMLWriter classes appear to have a sort order that consider dynamic and static methods different.

PlantUMLWriter has sterotypesSuffix() before beginAbstractClass(); dynamic methods appear to be in alphabetical order.

Association label appear to be near the arrow middle point. UML would require a role name to be near the arrow end, marked as -pw. Investigate PlantUML syntax.

To be precise, associations are non-navigable on the arrow source, missing and X.

Association name can not be recalled from code, only one of the roles/ends. Usually a tool refer to Role A, Role B.

Multiplicity and constraints are omitted; expected "1" or "0..1" -pw near the arrow.

println() and print() will not emit activeTag tag; check and document that.
No nesting on withTag() is allowed; check and document that.

In the source code, helpers are in the bottom of the list, but appear scattered in the diagram while dynamic methods are ordered; check that.

CollectTypesVisitor has static before dynamic fields; check that.

CollectRelationshipsVisitor has Utility methods and constants for PlantUML syntax, as CHAR_PACKAGE_SEPARATOR. PlantUML Syntax could be moved to a shared type.

Add logger to visitors. Emit FINER and FINEST level on each type and relation.

DeclaredIndex has a parameter idx: DeclaredIndex; check that. Remove parameter, if possible.
Same with fill() method.
Wait, both are static methods; check that.

TypeRef is a sealed type, but no relationship connects it with other records, like ExternalTypeRef.

[masmangan]

7 Run Path Resolution Tests (Jar outside, source below)

-d . resolution, source below, explicit
Minor plan deviation

masmangan@Marcos-iMac assis % mv class-diagram.puml class-diagram-base.puml
mv: rename class-diagram.puml to class-diagram-base.puml: No such file or directory

No diagram file to me; diagram was generated on docs/diagrams/src earlier.
NOTE: diagram default SVG folder convention is docs/diagrams/svg

Diagram has no end type }, because of BUG #37.
Using find and replace to fix file.
Find: /' @assis:end
Replace: } /' @assis:end

Note: second fix required; must use replace ALL.
Note: third fix required; should not replace on end packages. Best fix, replace all, review packages.

Note:
masmangan@Marcos-iMac assis % plantuml --svg class-diagram.puml

Shows no errors, no warnings; check plantuml syntax for pedantic mode.

Smoke test and this test have the same .puml, except for package manual edit unintentional white spaces.
masmangan@Marcos-iMac assis % diff class-diagram.puml assis-core/docs/diagrams/src/class-diagram.puml
133c133
< } /' @assis:end package "io.github.masmangan.assis" '/

} /' @assis:end package "io.github.masmangan.assis" '/
183c183
< } /' @assis:end package "io.github.masmangan.assis.deps" '/

---

} /' @assis:end package "io.github.masmangan.assis.deps" '/

[masmangan]

Review plan text to number tests 7.2 -d out1...

Same diagram as smoke test, except for end type fix manual editing.

[masmangan]

-d out2 resolution, folder must be created, source below, explicit

Same diagram content as smoke test.

[masmangan]

-d . resolution, source below, src is one level down (Test plan v0.9.3 failure)

Minor plan deviation
cd ..
java -jar ../assis-cli.jar -sourcepath assis-core -d .

should be

cd ..
java -jar assis-cli.jar -sourcepath assis-core -d .

masmangan@Marcos-iMac assis-0-9-3-test % java -jar assis-cli.jar -sourcepath assis-core -d .
Jan 11, 2026 9:57:59 AM io.github.masmangan.assis.cli.SourceLocator extractRequested
INFO: Using explicit source path (javac-like): /Users/masmangan/assis-0-9-3-test/assis-core
Jan 11, 2026 9:57:59 AM io.github.masmangan.assis.cli.AssisApp run
SEVERE: Source path does not exist: /Users/masmangan/assis-0-9-3-test/assis-core

Minor plan deviation.
assis-core does not exist at this level. assis parent exists.

masmangan@Marcos-iMac assis-0-9-3-test % java -jar assis-cli.jar -sourcepath assis -d .
Jan 11, 2026 10:01:46 AM io.github.masmangan.assis.cli.SourceLocator extractRequested
INFO: Using explicit source path (javac-like): /Users/masmangan/assis-0-9-3-test/assis
Jan 11, 2026 10:01:46 AM io.github.masmangan.assis.cli.AssisApp run
INFO: Generating diagrams from source roots:
Jan 11, 2026 10:01:46 AM io.github.masmangan.assis.cli.AssisApp run
INFO: - /Users/masmangan/assis-0-9-3-test/assis
Jan 11, 2026 10:01:46 AM io.github.masmangan.assis.cli.AssisApp run
INFO: Writing outputs to: /Users/masmangan/assis-0-9-3-test
Jan 11, 2026 10:01:46 AM io.github.masmangan.assis.GenerateClassDiagram scanSourceRoots
INFO: Scanning started
Jan 11, 2026 10:01:46 AM io.github.masmangan.assis.GenerateClassDiagram scanSourceRoots
INFO: Scanning /Users/masmangan/assis-0-9-3-test/assis
Jan 11, 2026 10:01:46 AM io.github.masmangan.assis.GenerateClassDiagram generate
INFO: Writing /Users/masmangan/assis-0-9-3-test/class-diagram.puml

Diagram is generated, no types or relations inside.

masmangan@Marcos-iMac assis-0-9-3-test % more class-diagram.puml
@startuml "class-diagram"

hide empty members

!theme blueprint
!pragma useIntermediatePackages false

left to right direction

' Diagram generated with ASSIS compiler (0.9.3).
' https://github.com/masmangan/assis

@enduml

-d . resolution, source below, src is one level down (Test plan v0.9.3 failure)

java -jar assis-cli.jar -sourcepath assis -d .

Reproduces the BUG #38 with a combination of sourcepath and d, in a monorepo layout.
assis-core is generating an incomplete diagram.

masmangan@Marcos-iMac assis-0-9-3-test % java -jar assis-cli.jar -sourcepath assis/assis-core -d .

Gets the complete assis-core diagram, including non src .java on samples.

[masmangan]

Test result: FAIL on
-d . resolution, source below, src is one level down (Test plan v0.9.3 failure)

java -jar assis-cli.jar -sourcepath assis-core -d .