@git.zone/tsdoc 1.3.4 → 1.3.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/aidocs_classes/commit.js +9 -5
- package/dist_ts/aidocs_classes/projectcontext.js +1 -2
- package/package.json +1 -1
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/aidocs_classes/commit.ts +8 -4
- package/ts/aidocs_classes/projectcontext.ts +0 -1
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
*/
|
|
4
4
|
export const commitinfo = {
|
|
5
5
|
name: '@git.zone/tsdoc',
|
|
6
|
-
version: '1.3.
|
|
6
|
+
version: '1.3.6',
|
|
7
7
|
description: 'An advanced TypeScript documentation tool using AI to generate and enhance documentation for TypeScript projects.'
|
|
8
8
|
};
|
|
9
9
|
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxpQkFBaUI7SUFDdkIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLG1IQUFtSDtDQUNqSSxDQUFBIn0=
|
|
@@ -10,7 +10,7 @@ export class Commit {
|
|
|
10
10
|
const smartgitInstance = new plugins.smartgit.Smartgit();
|
|
11
11
|
await smartgitInstance.init();
|
|
12
12
|
const gitRepo = await plugins.smartgit.GitRepo.fromOpeningRepoDir(smartgitInstance, this.projectDir);
|
|
13
|
-
const
|
|
13
|
+
const diffStringArray = await gitRepo.getUncommittedDiff(['pnpm-lock.json']);
|
|
14
14
|
const projectContext = new ProjectContext(this.projectDir);
|
|
15
15
|
let contextString = await projectContext.update();
|
|
16
16
|
contextString = `
|
|
@@ -18,7 +18,7 @@ ${contextString}
|
|
|
18
18
|
|
|
19
19
|
Below is the diff of the uncommitted changes. If nothing is changed, there are no changes:
|
|
20
20
|
|
|
21
|
-
${
|
|
21
|
+
${diffStringArray[0] ? diffStringArray.join('\n\n') : 'No changes.'}
|
|
22
22
|
`;
|
|
23
23
|
let result = await this.aiDocsRef.openaiInstance.chat({
|
|
24
24
|
systemMessage: `
|
|
@@ -41,6 +41,8 @@ interface {
|
|
|
41
41
|
recommendedNextVersion: string; // the recommended next version of the project, x.x.x
|
|
42
42
|
}
|
|
43
43
|
|
|
44
|
+
For the recommendedNextVersionDetails, please only add a detail entries to the array if it has an obvious value to the reader.
|
|
45
|
+
|
|
44
46
|
You are being given the files of the project. You should use them to create the commit message.
|
|
45
47
|
Also you are given a diff
|
|
46
48
|
|
|
@@ -58,16 +60,18 @@ Also you are given a diff
|
|
|
58
60
|
if (!previousChangelog) {
|
|
59
61
|
// lets build the changelog based on that
|
|
60
62
|
const commitMessages = await gitRepo.getAllCommitMessages();
|
|
63
|
+
console.log(JSON.stringify(commitMessages, null, 2));
|
|
61
64
|
let result2 = await this.aiDocsRef.openaiInstance.chat({
|
|
62
65
|
messageHistory: [],
|
|
63
66
|
systemMessage: `
|
|
64
67
|
You are building a changelog.md file for the project.
|
|
65
|
-
Omit commits and versions that lack relevant changes.
|
|
68
|
+
Omit commits and versions that lack relevant changes, but make sure to mention them as a range with a summarizing message instead.
|
|
66
69
|
|
|
67
70
|
A changelog entry should look like this:
|
|
68
71
|
|
|
69
72
|
## yyyy-mm-dd - x.x.x - scope here
|
|
70
73
|
main descriptiom here
|
|
74
|
+
|
|
71
75
|
- detailed bullet points follow
|
|
72
76
|
|
|
73
77
|
You are given:
|
|
@@ -88,9 +92,9 @@ ${JSON.stringify(commitMessages, null, 2)}
|
|
|
88
92
|
{{nextVersionMessage}}
|
|
89
93
|
|
|
90
94
|
{{nextVersionDetails}}
|
|
91
|
-
`}\n\n${oldChangelog}
|
|
95
|
+
`}\n\n${oldChangelog}`;
|
|
92
96
|
resultObject.changelog = newChangelog;
|
|
93
97
|
return resultObject;
|
|
94
98
|
}
|
|
95
99
|
}
|
|
96
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
100
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tbWl0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvYWlkb2NzX2NsYXNzZXMvY29tbWl0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sZUFBZSxDQUFDO0FBQ3pDLE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUM1QyxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFXckQsTUFBTSxPQUFPLE1BQU07SUFJakIsWUFBWSxTQUFnQixFQUFFLGFBQXFCO1FBQ2pELElBQUksQ0FBQyxTQUFTLEdBQUcsU0FBUyxDQUFDO1FBQzNCLElBQUksQ0FBQyxVQUFVLEdBQUcsYUFBYSxDQUFDO0lBQ2xDLENBQUM7SUFFTSxLQUFLLENBQUMscUJBQXFCO1FBQ2hDLE1BQU0sZ0JBQWdCLEdBQUcsSUFBSSxPQUFPLENBQUMsUUFBUSxDQUFDLFFBQVEsRUFBRSxDQUFDO1FBQ3pELE1BQU0sZ0JBQWdCLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDOUIsTUFBTSxPQUFPLEdBQUcsTUFBTSxPQUFPLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQyxrQkFBa0IsQ0FDL0QsZ0JBQWdCLEVBQ2hCLElBQUksQ0FBQyxVQUFVLENBQ2hCLENBQUM7UUFDRixNQUFNLGVBQWUsR0FBRyxNQUFNLE9BQU8sQ0FBQyxrQkFBa0IsQ0FBQyxDQUFDLGdCQUFnQixDQUFDLENBQUMsQ0FBQztRQUM3RSxNQUFNLGNBQWMsR0FBRyxJQUFJLGNBQWMsQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLENBQUM7UUFDM0QsSUFBSSxhQUFhLEdBQUcsTUFBTSxjQUFjLENBQUMsTUFBTSxFQUFFLENBQUM7UUFDbEQsYUFBYSxHQUFHO0VBQ2xCLGFBQWE7Ozs7RUFJYixlQUFlLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLGVBQWUsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxDQUFDLGFBQWE7S0FDOUQsQ0FBQztRQUVGLElBQUksTUFBTSxHQUFHLE1BQU0sSUFBSSxDQUFDLFNBQVMsQ0FBQyxjQUFjLENBQUMsSUFBSSxDQUFDO1lBQ3BELGFBQWEsRUFBRTs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztDQXlCcEI7WUFDSyxjQUFjLEVBQUUsRUFBRTtZQUNsQixXQUFXLEVBQUUsYUFBYTtTQUMzQixDQUFDLENBQUM7UUFFSCwrQkFBK0I7UUFDL0IsTUFBTSxZQUFZLEdBQXNCLElBQUksQ0FBQyxLQUFLLENBQ2hELE1BQU0sQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLFNBQVMsRUFBRSxFQUFFLENBQUMsQ0FBQyxPQUFPLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxDQUN6RCxDQUFDO1FBRUYsTUFBTSxxQkFBcUIsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsVUFBVSxFQUFFLGNBQWMsQ0FBQyxDQUFDO1FBQ2pGLElBQUksaUJBQThDLENBQUM7UUFDbkQsSUFBSSxNQUFNLE9BQU8sQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDLFVBQVUsQ0FBQyxxQkFBcUIsQ0FBQyxFQUFFLENBQUM7WUFDakUsaUJBQWlCLEdBQUcsTUFBTSxPQUFPLENBQUMsU0FBUyxDQUFDLFNBQVMsQ0FBQyxZQUFZLENBQUMscUJBQXFCLENBQUMsQ0FBQztRQUM1RixDQUFDO1FBRUQsSUFBSSxDQUFDLGlCQUFpQixFQUFFLENBQUM7WUFDdkIseUNBQXlDO1lBQ3pDLE1BQU0sY0FBYyxHQUFHLE1BQU0sT0FBTyxDQUFDLG9CQUFvQixFQUFFLENBQUM7WUFDNUQsT0FBTyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLGNBQWMsRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztZQUNyRCxJQUFJLE9BQU8sR0FBRyxNQUFNLElBQUksQ0FBQyxTQUFTLENBQUMsY0FBYyxDQUFDLElBQUksQ0FBQztnQkFDckQsY0FBYyxFQUFFLEVBQUU7Z0JBQ2xCLGFBQWEsRUFBRTs7Ozs7Ozs7Ozs7Ozs7OEVBY3VEO2dCQUN0RSxXQUFXLEVBQUU7OztFQUduQixJQUFJLENBQUMsU0FBUyxDQUFDLGNBQWMsRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO0dBQ3RDO2FBQ0ksQ0FBQyxDQUFDO1lBRUgsaUJBQWlCLEdBQUcsTUFBTSxPQUFPLENBQUMsU0FBUyxDQUFDLFNBQVMsQ0FBQyxVQUFVLENBQzlELHFCQUFxQixFQUNyQixPQUFPLENBQUMsT0FBTyxFQUNmLE1BQU0sQ0FDUCxDQUFDO1FBQ0osQ0FBQztRQUVELElBQUksWUFBWSxHQUFHLGlCQUFpQixDQUFDLFFBQVEsQ0FBQyxRQUFRLEVBQUUsQ0FBQyxPQUFPLENBQUMsaUJBQWlCLEVBQUUsRUFBRSxDQUFDLENBQUM7UUFDeEYsSUFBSSxhQUFhLEdBQUcsSUFBSSxPQUFPLENBQUMsU0FBUyxDQUFDLFlBQVksRUFBRSxDQUFDLDBCQUEwQixFQUFFLENBQUM7UUFDdEYsSUFBSSxZQUFZLEdBQUcsa0JBQWtCLE1BQU0sYUFBYTs7OztDQUkzRCxPQUFPLFlBQVksRUFBRSxDQUFDO1FBQ25CLFlBQVksQ0FBQyxTQUFTLEdBQUcsWUFBWSxDQUFDO1FBRXRDLE9BQU8sWUFBWSxDQUFDO0lBQ3RCLENBQUM7Q0FDRiJ9
|
|
@@ -21,7 +21,6 @@ export class ProjectContext {
|
|
|
21
21
|
};
|
|
22
22
|
}
|
|
23
23
|
async convertFilesToContext(filesArg) {
|
|
24
|
-
console.log(`Using the following files for the documentation:`);
|
|
25
24
|
filesArg.map((fileArg) => {
|
|
26
25
|
// console.log(` -> ${fileArg.relative}`);
|
|
27
26
|
});
|
|
@@ -55,4 +54,4 @@ ${smartfile.contents.toString()}
|
|
|
55
54
|
return result;
|
|
56
55
|
}
|
|
57
56
|
}
|
|
58
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
57
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvamVjdGNvbnRleHQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9haWRvY3NfY2xhc3Nlcy9wcm9qZWN0Y29udGV4dC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUV6QyxNQUFNLE9BQU8sY0FBYztJQUNsQixNQUFNLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxNQUFjLElBQUcsQ0FBQztJQUs5QyxZQUFZLGFBQXFCO1FBQy9CLElBQUksQ0FBQyxVQUFVLEdBQUcsYUFBYSxDQUFDO0lBQ2xDLENBQUM7SUFFTSxLQUFLLENBQUMsV0FBVztRQUN0QixNQUFNLG9CQUFvQixHQUFHLE1BQU0sT0FBTyxDQUFDLFNBQVMsQ0FBQyxTQUFTLENBQUMsWUFBWSxDQUN6RSxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsVUFBVSxFQUFFLGNBQWMsQ0FBQyxFQUNsRCxJQUFJLENBQUMsVUFBVSxDQUNoQixDQUFDO1FBQ0YsTUFBTSxnQkFBZ0IsR0FBRyxNQUFNLE9BQU8sQ0FBQyxTQUFTLENBQUMsU0FBUyxDQUFDLFlBQVksQ0FDckUsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLFVBQVUsRUFBRSxXQUFXLENBQUMsRUFDL0MsSUFBSSxDQUFDLFVBQVUsQ0FDaEIsQ0FBQztRQUVGLE1BQU0scUJBQXFCLEdBQUcsTUFBTSxPQUFPLENBQUMsU0FBUyxDQUFDLFNBQVMsQ0FBQyxZQUFZLENBQzFFLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxVQUFVLEVBQUUsaUJBQWlCLENBQUMsRUFDckQsSUFBSSxDQUFDLFVBQVUsQ0FDaEIsQ0FBQztRQUNGLE1BQU0sc0JBQXNCLEdBQUcsTUFBTSxPQUFPLENBQUMsU0FBUyxDQUFDLFNBQVMsQ0FBQyxZQUFZLENBQzNFLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxVQUFVLEVBQUUsZUFBZSxDQUFDLEVBQ25ELElBQUksQ0FBQyxVQUFVLENBQ2hCLENBQUM7UUFDRixNQUFNLGFBQWEsR0FBRyxNQUFNLE9BQU8sQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDLGdCQUFnQixDQUMvRCxJQUFJLENBQUMsVUFBVSxFQUNmLGFBQWEsQ0FDZCxDQUFDO1FBQ0YsTUFBTSxjQUFjLEdBQUcsTUFBTSxPQUFPLENBQUMsU0FBUyxDQUFDLEVBQUUsQ0FBQyxnQkFBZ0IsQ0FDaEUsSUFBSSxDQUFDLFVBQVUsRUFDZixjQUFjLENBQ2YsQ0FBQztRQUNGLE9BQU87WUFDTCxvQkFBb0I7WUFDcEIsZ0JBQWdCO1lBQ2hCLHFCQUFxQjtZQUNyQixzQkFBc0I7WUFDdEIsYUFBYTtZQUNiLGNBQWM7U0FDZixDQUFDO0lBQ0osQ0FBQztJQUVNLEtBQUssQ0FBQyxxQkFBcUIsQ0FBQyxRQUF1QztRQUN4RSxRQUFRLENBQUMsR0FBRyxDQUFDLENBQUMsT0FBTyxFQUFFLEVBQUU7WUFDdkIsMkNBQTJDO1FBQzdDLENBQUMsQ0FBQyxDQUFDO1FBQ0gsT0FBTyxRQUFRO2FBQ1osR0FBRyxDQUFDLENBQUMsU0FBUyxFQUFFLEVBQUU7WUFDakIsT0FBTzt1QkFDUSxTQUFTLENBQUMsUUFBUTs7RUFFdkMsU0FBUyxDQUFDLFFBQVEsQ0FBQyxRQUFRLEVBQUU7O3FCQUVWLFNBQVMsQ0FBQyxRQUFRO1NBQzlCLENBQUM7UUFDSixDQUFDLENBQUM7YUFDRCxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDaEIsQ0FBQztJQUVPLEtBQUssQ0FBQyxZQUFZLENBQUMsTUFBYztRQUN2QyxNQUFNLEtBQUssR0FBRyxNQUFNLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQztRQUN2QyxJQUFJLE9BQU8sR0FBRyxNQUFNLElBQUksQ0FBQyxxQkFBcUIsQ0FBQztZQUM3QyxLQUFLLENBQUMsb0JBQW9CO1lBQzFCLEtBQUssQ0FBQyxnQkFBZ0I7WUFDdEIsS0FBSyxDQUFDLHFCQUFxQjtZQUMzQixLQUFLLENBQUMsc0JBQXNCO1lBQzVCLEdBQUcsS0FBSyxDQUFDLGFBQWE7WUFDdEIsR0FBRyxLQUFLLENBQUMsY0FBYztTQUN4QixDQUFDLENBQUM7UUFDSCx3QkFBd0I7UUFDeEIsT0FBTyxPQUFPLENBQUM7SUFDakIsQ0FBQztJQUVNLEtBQUssQ0FBQyxNQUFNO1FBQ2pCLE1BQU0sTUFBTSxHQUFHLE1BQU0sSUFBSSxDQUFDLFlBQVksQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLENBQUM7UUFDeEQsT0FBTyxNQUFNLENBQUM7SUFDaEIsQ0FBQztDQUNGIn0=
|
package/package.json
CHANGED
package/ts/00_commitinfo_data.ts
CHANGED
|
@@ -27,7 +27,7 @@ export class Commit {
|
|
|
27
27
|
smartgitInstance,
|
|
28
28
|
this.projectDir
|
|
29
29
|
);
|
|
30
|
-
const
|
|
30
|
+
const diffStringArray = await gitRepo.getUncommittedDiff(['pnpm-lock.json']);
|
|
31
31
|
const projectContext = new ProjectContext(this.projectDir);
|
|
32
32
|
let contextString = await projectContext.update();
|
|
33
33
|
contextString = `
|
|
@@ -35,7 +35,7 @@ ${contextString}
|
|
|
35
35
|
|
|
36
36
|
Below is the diff of the uncommitted changes. If nothing is changed, there are no changes:
|
|
37
37
|
|
|
38
|
-
${
|
|
38
|
+
${diffStringArray[0] ? diffStringArray.join('\n\n') : 'No changes.'}
|
|
39
39
|
`;
|
|
40
40
|
|
|
41
41
|
let result = await this.aiDocsRef.openaiInstance.chat({
|
|
@@ -59,6 +59,8 @@ interface {
|
|
|
59
59
|
recommendedNextVersion: string; // the recommended next version of the project, x.x.x
|
|
60
60
|
}
|
|
61
61
|
|
|
62
|
+
For the recommendedNextVersionDetails, please only add a detail entries to the array if it has an obvious value to the reader.
|
|
63
|
+
|
|
62
64
|
You are being given the files of the project. You should use them to create the commit message.
|
|
63
65
|
Also you are given a diff
|
|
64
66
|
|
|
@@ -81,16 +83,18 @@ Also you are given a diff
|
|
|
81
83
|
if (!previousChangelog) {
|
|
82
84
|
// lets build the changelog based on that
|
|
83
85
|
const commitMessages = await gitRepo.getAllCommitMessages();
|
|
86
|
+
console.log(JSON.stringify(commitMessages, null, 2));
|
|
84
87
|
let result2 = await this.aiDocsRef.openaiInstance.chat({
|
|
85
88
|
messageHistory: [],
|
|
86
89
|
systemMessage: `
|
|
87
90
|
You are building a changelog.md file for the project.
|
|
88
|
-
Omit commits and versions that lack relevant changes.
|
|
91
|
+
Omit commits and versions that lack relevant changes, but make sure to mention them as a range with a summarizing message instead.
|
|
89
92
|
|
|
90
93
|
A changelog entry should look like this:
|
|
91
94
|
|
|
92
95
|
## yyyy-mm-dd - x.x.x - scope here
|
|
93
96
|
main descriptiom here
|
|
97
|
+
|
|
94
98
|
- detailed bullet points follow
|
|
95
99
|
|
|
96
100
|
You are given:
|
|
@@ -117,7 +121,7 @@ ${JSON.stringify(commitMessages, null, 2)}
|
|
|
117
121
|
{{nextVersionMessage}}
|
|
118
122
|
|
|
119
123
|
{{nextVersionDetails}}
|
|
120
|
-
`}\n\n${oldChangelog}
|
|
124
|
+
`}\n\n${oldChangelog}`;
|
|
121
125
|
resultObject.changelog = newChangelog;
|
|
122
126
|
|
|
123
127
|
return resultObject;
|
|
@@ -47,7 +47,6 @@ export class ProjectContext {
|
|
|
47
47
|
}
|
|
48
48
|
|
|
49
49
|
public async convertFilesToContext(filesArg: plugins.smartfile.SmartFile[]) {
|
|
50
|
-
console.log(`Using the following files for the documentation:`);
|
|
51
50
|
filesArg.map((fileArg) => {
|
|
52
51
|
// console.log(` -> ${fileArg.relative}`);
|
|
53
52
|
});
|