changelog.md

@@ -1,109 +0,0 @@
-# Changelog
-
-## 2025-02-25 - 1.4.4 - fix(dependencies)
-Update dependencies to latest versions
-
-- Updated '@push.rocks/smartai' from '^0.0.17' to '^0.4.2'
-- Updated 'typedoc' from '^0.26.1' to '^0.27.9'
-
-## 2025-01-14 - 1.4.3 - fix(aidocs_classes)
-Improve readme generation instructions to ensure correct markdown formatting.
-
-- Added guidance to avoid using backticks at the beginning and end of readme generation to prevent markdown issues.
-- Clarified that the output is directly written to readme.md and backticks should only be used for code blocks.
-
-## 2024-10-28 - 1.4.2 - fix(cli)
-Ensure async completion for aidoc readme and description generation
-
-- Added await statements for asynchronous methods buildReadme and buildDescription in the aidoc command.
-
-## 2024-10-28 - 1.4.1 - fix(readme)
-Correct async call to getModuleSubDirs in readme generation.
-
-- Fixed an issue with asynchronous handling in readme generation for submodules.
-- Ensured that getModuleSubDirs function is called with await to handle promises properly.
-
-## 2024-10-28 - 1.4.0 - feat(aidocs)
-Added support for building readmes for sub-modules in aidocs
-
-- Updated the `Readme` class to handle monorepo projects by generating readmes for sub-modules.
-- Integrated `tspublish` to identify sub-modules for readme generation.
-
-## 2024-06-24 - 1.3.12 - fix(aidocs)
-Fix changelog generation by handling leading newlines
-
-- Fixed handling of leading newlines in the changelog to ensure proper formatting.
-
-## 2024-06-23 - 1.3.11 - fix(core)
-Fixed new changelog formatting issue to retain consistent spacing.
-
-- Adjusted the new changelog generation to ensure consistent spacing for improved readability.
-
-## 2024-06-23 - 1.3.10 - fix(aidocs_classes)
-Fix changelog format to remove extra newline
-
-- Updated `ts/aidocs_classes/commit.ts` to fix the changelog format.
-
-## 2024-06-23 - 1.3.9 - fix(aidoc)
-Fix changelog generation by properly stripping markdown code fences
-
-- Corrected the changelog generation code to ensure markdown code fences are properly stripped.
-
-
-## 2024-06-23 - 1.3.8 - fix(changelog)
-Fix changelog generation by properly stripping markdown code fences
-
-- Corrected the changelog generation code to ensure markdown code fences are properly stripped.
-
-## 2024-06-23 - 1.3.7 - fix(aidoc)
-Update to include package-lock.json in uncommitted changes check
-
-- Modified the getUncommittedDiff method call in commit.ts to include package-lock.json along with pnpm-lock.yaml
-
-
-## 2024-06-23 - 1.3.6 - fix(commit)
-Fixed issue with retrieving uncommitted diffs in git repository
-
-- Revised logic to correctly handle uncommitted changes by using an array for `getUncommittedDiff` method
-- Ensured proper handling and representation of uncommitted changes in the output
-
-
-## 2024-06-23 - 1.3.5 - fix(aidocs_classes)
-Refactor and enhance changelog formatting
-
-- Updated the `commit.ts` file to improve the changelog formatting and ensure consistency.
-- Enhanced the changelog instructions to include summarizing messages for omitted commits.
-- Removed unnecessary console logging in `projectcontext.ts`.
-
-
-```markdown
-## 2024-06-23 - 1.3.3 - fix(aidocs_classes)
-Fix changelog formatting issue in commit class
-
-## 2024-06-23 - 1.3.2 - fix(aidocs_classes)
-Fix minor bugs and update dependencies in aidocs_classes
-
-## 2024-06-23 - 1.3.1 - fix(aidocs_classes)
-Fix typo in INextCommitObject interface and update date format in changelog generation.
-
-## 2024-06-23 - 1.3.0 - fix(aidocs_classes)
-Fix typo in INextCommitObject interface
-
-## 2024-06-23 - 1.2.4 - feat(core)
-Added smarttime dependency and improved changelog generation
-
-## 2024-06-23 - 1.2.3 - fix(logging)
-Refactor logger initialization to use commitinfo data
-
-## 2024-06-23 - 1.2.2 - fix(aidocs)
-Fix bug in AiDoc class causing undefined token handling
-
-## 2024-06-23 - 1.2.0 - fix(core)
-Fixed usage of plugins in project context and readme generation
-
-## 2024-06-23 - 1.1.42 - feat(aidocs_classes)
-Enhance changelog generation by supporting complete generation in the absence of previous changelog files
-
-## 2024-06-23 - 1.1.41 - fix(aidocs_classes)
-Improve commit message generation by handling empty diffs and updating changelog instructions
-```

package.json

@@ -1,13 +1,12 @@
 {
   "name": "@git.zone/tsdoc",
-  "version": "1.4.4",
+  "version": "1.1.31",
   "private": false,
   "description": "An advanced TypeScript documentation tool using AI to generate and enhance documentation for TypeScript projects.",
+  "main": "dist_ts/index.js",
+  "typings": "dist_ts/index.d.ts",
   "type": "module",
-  "exports": {
+  "author": "Lossless GmbH",
-    ".": "./dist_ts/index.js"
-  },
-  "author": "Task Venture Capital GmbH",
   "license": "MIT",
   "bin": {
     "tsdoc": "cli.js"
@@ -23,25 +22,23 @@
     "@git.zone/tsrun": "^1.2.46",
     "@git.zone/tstest": "^1.0.90",
     "@push.rocks/tapbundle": "^5.0.23",
-    "@types/node": "^22.8.1"
+    "@types/node": "^20.14.8"
   },
   "dependencies": {
-    "@git.zone/tspublish": "^1.5.5",
     "@push.rocks/early": "^4.0.3",
     "@push.rocks/npmextra": "^5.0.23",
     "@push.rocks/qenv": "^6.0.5",
-    "@push.rocks/smartai": "^0.4.2",
+    "@push.rocks/smartai": "^0.0.17",
     "@push.rocks/smartcli": "^4.0.11",
     "@push.rocks/smartdelay": "^3.0.5",
     "@push.rocks/smartfile": "^11.0.20",
-    "@push.rocks/smartgit": "^3.1.0",
+    "@push.rocks/smartgit": "^3.0.4",
     "@push.rocks/smartinteract": "^2.0.15",
     "@push.rocks/smartlog": "^3.0.7",
     "@push.rocks/smartlog-destination-local": "^9.0.2",
     "@push.rocks/smartpath": "^5.0.18",
     "@push.rocks/smartshell": "^3.0.5",
-    "@push.rocks/smarttime": "^4.0.6",
+    "typedoc": "^0.26.0",
-    "typedoc": "^0.27.9",
     "typescript": "^5.5.2"
   },
   "files": [

test/test.aidoc.nonci.ts

@@ -15,25 +15,12 @@ tap.test('should create an AIdocs class', async () => {
 
 tap.test('should start AIdocs', async () => {
   await aidocs.start();
-});
-
-tap.skip.test('should start AIdocs', async () => {
   await aidocs.buildReadme('./');
 });
 
-tap.skip.test('should start AIdocs', async () => {
+tap.test('should start AIdocs', async () => {
+  await aidocs.start();
   await aidocs.buildDescription('./');
 });
 
-tap.test('should build commit object', async () => {
-  const commitObject = await aidocs.buildNextCommitObject('./');
-  console.log(commitObject);
-  expect(commitObject).not.toBeUndefined();
-  expect(commitObject).toHaveProperty('recommendedNextVersion');
-  expect(commitObject).toHaveProperty('recommendedNextVersionLevel');
-  expect(commitObject).toHaveProperty('recommendedNextVersionScope');
-  expect(commitObject).toHaveProperty('recommendedNextVersionMessage');
-
-})
-
 tap.start();

ts/00_commitinfo_data.ts

@@ -1,8 +1,8 @@
 /**
- * autocreated commitinfo by @push.rocks/commitinfo
+ * autocreated commitinfo by @pushrocks/commitinfo
  */
 export const commitinfo = {
   name: '@git.zone/tsdoc',
-  version: '1.4.4',
+  version: '1.1.31',
   description: 'An advanced TypeScript documentation tool using AI to generate and enhance documentation for TypeScript projects.'
 }

ts/aidocs_classes/commit.ts

@@ -2,15 +2,6 @@ import * as plugins from '../plugins.js';
 import { AiDoc } from '../classes.aidoc.js';
 import { ProjectContext } from './projectcontext.js';
 
-export interface INextCommitObject {
-  recommendedNextVersionLevel: 'fix' | 'feat' | 'BREAKING CHANGE'; // the recommended next version level of the project
-  recommendedNextVersionScope: string; // the recommended scope name of the next version, like "core" or "cli", or specific class names.
-  recommendedNextVersionMessage: string; // the commit message. Don't put fix() feat() or BREAKING CHANGE in the message. Please just the message itself.
-  recommendedNextVersionDetails: string[]; // detailed bullet points for the changelog
-  recommendedNextVersion: string; // the recommended next version of the project, x.x.x
-  changelog?: string; // the changelog for the next version
-}
-
 export class Commit {
   private aiDocsRef: AiDoc;
   private projectDir: string;
@@ -20,26 +11,9 @@ export class Commit {
     this.projectDir = projectDirArg;
   }
 
-  public async buildNextCommitObject(): Promise<INextCommitObject> {
+  public async build() {
-    const smartgitInstance = new plugins.smartgit.Smartgit();
-    await smartgitInstance.init();
-    const gitRepo = await plugins.smartgit.GitRepo.fromOpeningRepoDir(
-      smartgitInstance,
-      this.projectDir
-    );
-    const diffStringArray = await gitRepo.getUncommittedDiff([
-      'pnpm-lock.yaml',
-      'package-lock.json',
-    ]);
     const projectContext = new ProjectContext(this.projectDir);
-    let contextString = await projectContext.update();
+    const contextString = await projectContext.update();
-    contextString = `
-${contextString}
-
-Below is the diff of the uncommitted changes. If nothing is changed, there are no changes:
-
-${diffStringArray[0] ? diffStringArray.join('\n\n') : 'No changes.'}
-    `;
 
     let result = await this.aiDocsRef.openaiInstance.chat({
       systemMessage: `
@@ -53,17 +27,12 @@ Important: Answer only in valid JSON.
 Your answer should be parseable with JSON.parse() without modifying anything.
 
 Here is the structure of the JSON you should return:
-
+{
-interface {
+  recommendedNextVersionLevel: 'patch' | 'minor' | 'major'; // the recommended next version level of the project
-  recommendedNextVersionLevel: 'fix' | 'feat' | 'BREAKING CHANGE'; // the recommended next version level of the project
+  recommendedNextVersion: string; // the recommended next version of the project
-  recommendedNextVersionScope: string; // the recommended scope name of the next version, like "core" or "cli", or specific class names.
+  message: string; // the commit message. use conventional commits format
-  recommendedNextVersionMessage: string; // the commit message. Don't put fix() feat() or BREAKING CHANGE in the message. Please just the message itself.
-  recommendedNextVersionDetails: string[]; // detailed bullet points for the changelog
-  recommendedNextVersion: string; // the recommended next version of the project, x.x.x
 }
 
-For the recommendedNextVersionDetails, please only add a detail entries to the array if it has an obvious value to the reader.
-
 You are being given the files of the project. You should use them to create the commit message.
 Also you are given a diff
 
@@ -72,63 +41,15 @@ Also you are given a diff
       userMessage: contextString,
     });
 
-    // console.log(result.message);
+    console.log(result.message);
-    const resultObject: INextCommitObject = JSON.parse(
+    const resultObject = JSON.parse(result.message.replace('```json', '').replace('```', ''));
-      result.message.replace('```json', '').replace('```', '')
-    );
 
-    const previousChangelogPath = plugins.path.join(this.projectDir, 'changelog.md');
+    const npmextraJson = (await projectContext.gatherFiles()).smartfilesNpmextraJSON;
-    let previousChangelog: plugins.smartfile.SmartFile;
+    const npmextraJsonContent = JSON.parse(npmextraJson.contents.toString());
-    if (await plugins.smartfile.fs.fileExists(previousChangelogPath)) {
-      previousChangelog = await plugins.smartfile.SmartFile.fromFilePath(previousChangelogPath);
-    }
 
-    if (!previousChangelog) {
+    npmextraJsonContent.gitzone.module.commit = resultObject.message;
-      // lets build the changelog based on that
-      const commitMessages = await gitRepo.getAllCommitMessages();
-      console.log(JSON.stringify(commitMessages, null, 2));
-      let result2 = await this.aiDocsRef.openaiInstance.chat({
-        messageHistory: [],
-        systemMessage: `
-You are building a changelog.md file for the project.
-Omit commits and versions that lack relevant changes, but make sure to mention them as a range with a summarizing message instead.
 
-A changelog entry should look like this:
+    npmextraJson.contents = Buffer.from(JSON.stringify(npmextraJsonContent, null, 2));
-
+    await npmextraJson.write();
-    ## yyyy-mm-dd - x.x.x - scope here
-    main descriptiom here
-
-    - detailed bullet points follow
-
-You are given:
-* the commit messages of the project
-
-Only return the changelog file, so it can be written directly to changelog.md`,
-        userMessage: `
-Here are the commit messages:
-
-${JSON.stringify(commitMessages, null, 2)}
-  `,
-      });
-
-      previousChangelog = await plugins.smartfile.SmartFile.fromString(
-        previousChangelogPath,
-        result2.message.replaceAll('```markdown', '').replaceAll('```', ''),
-        'utf8'
-      );
-    }
-
-    let oldChangelog = previousChangelog.contents.toString().replace('# Changelog\n\n', '');
-    if (oldChangelog.startsWith('\n')) {
-      oldChangelog = oldChangelog.replace('\n', '');
-    }
-    let newDateString = new plugins.smarttime.ExtendedDate().exportToHyphedSortableDate();
-    let newChangelog = `# Changelog\n\n${`## ${newDateString} - {{nextVersion}} - {{nextVersionScope}}
-{{nextVersionMessage}}
-
-{{nextVersionDetails}}`}\n\n${oldChangelog}`;
-    resultObject.changelog = newChangelog;
-
-    return resultObject;
   }
 }

ts/aidocs_classes/index.ts

@@ -1,4 +1,3 @@
-export * from './commit.js';
 export * from './description.js';
 export * from './projectcontext.js';
 export * from './readme.js';

ts/aidocs_classes/projectcontext.ts

@@ -47,8 +47,9 @@ export class ProjectContext {
   }
 
   public async convertFilesToContext(filesArg: plugins.smartfile.SmartFile[]) {
+    console.log(`Using the following files for the documentation:`);
     filesArg.map((fileArg) => {
-      // console.log(`  -> ${fileArg.relative}`);
+      console.log(`  -> ${fileArg.relative}`);
     });
     return filesArg
       .map((smartfile) => {

ts/aidocs_classes/readme.ts

@@ -1,8 +1,6 @@
 import type { AiDoc } from '../classes.aidoc.js';
 import * as plugins from '../plugins.js';
-import * as paths from '../paths.js';
 import { ProjectContext } from './projectcontext.js';
-import { logger } from '../logging.js';
 
 export class Readme {
   // INSTANCE
@@ -23,7 +21,7 @@ export class Readme {
 
     // lets first check legal before introducung any cost
     const npmExtraJson = JSON.parse(
-      (await projectContext.gatherFiles()).smartfilesNpmextraJSON.contents.toString()
+      (await projectContext.gatherFiles()).smartfilesNpmextraJSON.contents.toString(),
     );
     const legalInfo = npmExtraJson?.tsdoc?.legal;
     if (!legalInfo) {
@@ -81,64 +79,6 @@ The Readme should follow the following template:
     readme.contents = Buffer.from(finalReadmeString);
     await readme.write();
 
-    // lets care about monorepo aspects
-    const tsPublishInstance = new plugins.tspublish.TsPublish();
-    const subModules = await tsPublishInstance.getModuleSubDirs(paths.cwd);
-    logger.log('info', `Found ${Object.keys(subModules).length} sub modules`);
-    for (const subModule of Object.keys(subModules)) {
-      logger.log('info', `Building readme for ${subModule}`);
-      const subModuleContextString = await projectContext.update();
-      let result = await this.aiDocsRef.openaiInstance.chat({
-        systemMessage: `
-  You create markdown readmes for npm projects. You only output the markdown readme.
-
-  IMPORTANT: YOU ARE NOW CREATING THE README FOR THE FOLLOWING SUB MODULE: ${subModule} !!!!!!!!!!!
-  The Sub Module will be published with the following data:
-  ${JSON.stringify(plugins.smartfile.fs.toStringSync(plugins.path.join(paths.cwd, subModule, 'tspublish.json')), null, 2)}
-
-  
-  The Readme should follow the following template:
-  
-  # Project Name
-  [
-    The name is the module name of package.json
-    The description is in the description field of package.json
-  ]
-  
-  ## Install
-  [
-    Write a short text on how to install the project
-  ]
-  
-  ## Usage
-  [ 
-    Give code examples here.
-    Construct sensible scenarios for the user.
-    Make sure to show a complete set of features of the module.
-    Don't omit use cases.
-    It does not matter how much time you need.
-    ALWAYS USE ESM SYNTAX AND TYPESCRIPT.
-    DON'T CHICKEN OUT. Write at least 4000 words. More if necessary.
-    If there is already a readme, take the Usage section as base. Remove outdated content, and expand and improve upon the valid parts.
-    Super important: Check for completenes.
-    Don't include any licensing information. This will be added in a later step.
-    Avoid "in conclusions".
-  
-    Good to know:
-    * npmextra.json contains overall module information.
-    * readme.hints.md provides valuable hints about module ideas.
-    * Your output lands directly in the readme.md file.
-    * Don't use \`\`\` at the beginning or the end. It'll cause problems. Only use it for codeblocks. You are directly writing markdown. No need to introduce it weirdly.
-  ]
-              `,
-        messageHistory: [],
-        userMessage: subModuleContextString,
-      });
-
-      const subModuleReadmeString = result.message + '\n' + legalInfo;
-      await plugins.smartfile.memory.toFs(subModuleReadmeString, plugins.path.join(paths.cwd, subModule, 'readme.md'));
-      logger.log('success', `Built readme for ${subModule}`);
-    }
     return result.message;
   }
 }

ts/classes.aidoc.ts

@@ -7,7 +7,7 @@ export class AiDoc {
 
   public npmextraKV: plugins.npmextra.KeyValueStore;
   public qenvInstance: plugins.qenv.Qenv;
-  public aidocInteract: plugins.smartinteract.SmartInteract;
+  public smartinteractInstance: plugins.smartinteract.SmartInteract;
   public openaiInstance: plugins.smartai.OpenAiProvider;
 
   argvArg: any;
@@ -33,7 +33,7 @@ export class AiDoc {
 
   public async start() {
     // lets care about prerequisites
-    this.aidocInteract = new plugins.smartinteract.SmartInteract();
+    this.smartinteractInstance = new plugins.smartinteract.SmartInteract();
     this.qenvInstance = new plugins.qenv.Qenv();
     if (!(await this.qenvInstance.getEnvVarOnDemand('OPENAI_TOKEN'))) {
       this.npmextraKV = new plugins.npmextra.KeyValueStore({
@@ -51,9 +51,9 @@ export class AiDoc {
           // lets try smartinteract
           // wait for a second until OpenAI fixes punycode problem...
           await plugins.smartdelay.delayFor(1000);
-          const answerObject = await this.aidocInteract.askQuestion({
+          const answerObject = await this.smartinteractInstance.askQuestion({
             type: 'input',
-            message: `Please provide your OpenAI token. This will be persisted in your home directory.`,
+            message: `Please provide your OpenAI token`,
             name: 'OPENAI_TOKEN',
             default: '',
           });
@@ -85,10 +85,7 @@ export class AiDoc {
     return await descriptionInstance.build();
   }
 
-  public async buildNextCommitObject(projectDirArg: string) {
+  public async buildNextCommit(projectDirArg: string) {}
-    const commitInstance = new aiDocsClasses.Commit(this, projectDirArg);
-    return await commitInstance.buildNextCommitObject();
-  }
 
   public async getProjectContext(projectDirArg: string) {
     const projectContextInstance = new aiDocsClasses.ProjectContext(projectDirArg);

ts/cli.ts

@@ -28,14 +28,14 @@ export const run = async () => {
   });
 
   tsdocCli.addCommand('aidoc').subscribe(async (argvArg) => {
-    const aidocInstance = new AiDoc();
-    await aidocInstance.start();
     logger.log('info', `Generating new readme...`);
     logger.log('info', `This may take some time...`);
-    await aidocInstance.buildReadme(paths.cwd);
+    const aidocInstance = new AiDoc();
+    await aidocInstance.start();
+    aidocInstance.buildReadme(paths.cwd);
     logger.log('info', `Generating new keywords...`);
     logger.log('info', `This may take some time...`);
-    await aidocInstance.buildDescription(paths.cwd);
+    aidocInstance.buildDescription(paths.cwd);
   });
 
   tsdocCli.addCommand('test').subscribe((argvArg) => {

ts/logging.ts

@@ -1,6 +1,15 @@
-import { commitinfo } from './00_commitinfo_data.js';
 import * as plugins from './plugins.js';
 
-export const logger = plugins.smartlog.Smartlog.createForCommitinfo(commitinfo);
+export const logger = new plugins.smartlog.Smartlog({
+  logContext: {
+    company: 'Some Company',
+    companyunit: 'Some CompanyUnit',
+    containerName: 'Some Containername',
+    environment: 'local',
+    runtime: 'node',
+    zone: 'gitzone',
+  },
+  minimumLogLevel: 'silly',
+});
 
 logger.addLogDestination(new plugins.smartlogDestinationLocal.DestinationLocal());

ts/plugins.ts

@@ -16,7 +16,6 @@ import * as smartlog from '@push.rocks/smartlog';
 import * as smartlogDestinationLocal from '@push.rocks/smartlog-destination-local';
 import * as smartpath from '@push.rocks/smartpath';
 import * as smartshell from '@push.rocks/smartshell';
-import * as smarttime from '@push.rocks/smarttime';
 
 export {
   npmextra,
@@ -31,14 +30,8 @@ export {
   smartlogDestinationLocal,
   smartpath,
   smartshell,
-  smarttime,
 };
 
-// @git.zone scope
-import * as tspublish from '@git.zone/tspublish';
-
-export { tspublish };
-
 // third party scope
 import * as typedoc from 'typedoc';