autoforce 0.1.11 → 0.1.13

package/CHANGELOG.md

@@ -1,7 +1,34 @@
 # Versiones
+## Version 0.1.12
+- Fecha: 8/12/2024
+- Paquete: [Descargar](https://www.npmjs.com/package/autoforce/v/0.1.12)
+- Cambios:
+    * [Publish] ponga en Changelog todos los issues Closed del milestone asociado. Y los mueva al final de todo  a la Columna "Published"
+        - https://github.com/sebastianclaros/autoforce/issues/11
+    * [List] Poner Filtros: Abiertos Mios, Por Label, Por Milestone
+        - https://github.com/sebastianclaros/autoforce/issues/17
+    * [List] Guardar en autoforce el list default list template y default list Filter
+        - https://github.com/sebastianclaros/autoforce/issues/18
+    * [new Issue] Agregar Milestone
+        - https://github.com/sebastianclaros/autoforce/issues/19
+    * [config] dividir config general en config por comandos
+        - https://github.com/sebastianclaros/autoforce/issues/27
+    * [list] que tome de los argumentos valores.
+        - https://github.com/sebastianclaros/autoforce/issues/28
+    * [list] que reciba argumentos en taskFunctions y que tome orden de precedencia parametros de funcion, argumentos de comando y por ultimo autoforce.json
+        - https://github.com/sebastianclaros/autoforce/issues/29
+    * [new] que el milestone sea opcional
+        - https://github.com/sebastianclaros/autoforce/issues/30
+
+## Version 0.1.11
+- Fecha: 29/11/2024
+- Paquete: [Descargar](https://www.npmjs.com/package/autoforce/v/0.1.11)
+- Cambios:
+    * [comando config lea del autoforce.json](https://github.com/sebastianclaros/autoforce/issues/4)
 
 ## Version 0.1.10
 - Fecha: 28/11/2024
+- Paquete: [Descargar](https://www.npmjs.com/package/autoforce/v/0.1.10)
 - Cambios:
     * [publish deberia pedir la version, y asignarla en el autoforce version](https://github.com/sebastianclaros/autoforce/issues/12)
     * [Models en config que lea un json descriptivo](https://github.com/sebastianclaros/autoforce/issues/9)
@@ -16,6 +43,7 @@
 
 ## Version 0.1.9
 
+- Paquete: [Descargar](https://www.npmjs.com/package/autoforce/v/0.1.9)
 - Cambios:
     * Comando de new issue para crear un issue nuevo en el backlog
     * Comando de list para ver issues en backlog o ver los detalles de uno

package/README.md

@@ -1,18 +1,33 @@
 # Autoforce
 
-El proyecto esta en Beta todavia, recien fue migrado a Typescript y paso de ser unos scripts aislados a un modulo que se puede instalar y ejecutar directamente tipo CLI.
+El proyecto esta todavia en Beta todavia, pero la idea es que pueda estar productivo para algunos proyectos pronto.
 
 
 ## Objetivo
 
-La motivacion de crear la herramienta fue facilitar y automatizar las tareas comunes que realizamos los desarrolladores, especialmente los que utilizamos Salesforce.
+Hace un tiempo estabamos armando un repo para hacer practicas sobre Salesforce. Y empezamos a crear unos scripts para crear una instancia y subir el codigo. La idea fue evolucionando, y los scripts se fueron complejizando. Tambien surgieron limitaciones, si algo fallaba se quedaba por la mitad, los que tenian windows algunas cosas no funcionaban, y termine moviendo la idea a una herramienta.
 
-Me vi en la necesidad de tener una herramienta porque muchas veces me ganaba la ansiedad y queria hacer varios cambios juntos. Sentia que hacer varios stories, cada una con su branch, y todo el proceso era perder mucho tiempo. Pero cuando uno logra automatizar el repositorio queda mas prolijo y la trazabilidad tambien, y permite que otros desarrolladores puedan colaborar de forma mas simple.
+El objetivo termino siendo facilitar y automatizar las tareas comunes que realizamos los desarrolladores. Si bien empece con Salesforce, la idea es generalizarla para que soporte distintos modelos, de hecho uno es para este mismo proyecto :)
 
-En general cuando desarrollamos, repetimos mas o menos las mismas tareas. Arrancamos a desarrollar algo nuevo (start), terminamos ese desarrollo(finish), o bien dejarlo a un costado (stop), y posiblemente lo descartamos por completo (cancel). Dependiendo la tecnologia, el tipo de desarrollo, y que estrategia de branching, entre otras cosas mas, estas tareas podrian ser distintas.
+## Orden en un Repositorio
 
-En este repo las tareas buscan automatizar o integrar el siguiente tipo gestiones:
+Soy muy ansioso, y muchas veces queria hacer varios cambios juntos, el famoso ya que estoy aca tocando, o se me ocurrio algo. Pero despues es dificil de seguir, o se hacen mas largas las code reviews, etc.
 
+Asi que el primer objetivo fue organizar el proyecto, si tengo una idea la guardo enseguida (new). Y si quiero arrancar algo, puedo empezar por ver las proximas stories (list). 
+
+
+## Tareas repetitivas
+
+El segundo objetivo fue que pueda arrancar el desarrollo y arme el entorno, cree una branch y suba datos de prueba (start). Y por otro lado, cuando termine ese desarrollo,que baje los cambios en la scratch, documente, y valide la calidad del codigo(finish).
+
+Basicamente las tareas comunes que identificamos fueron:
+1. start
+2. finish
+3. stop
+4. cancel
+
+
+En cada una de ellas buscamos automatizar o integrar las siguientes gestiones:
 - Branching Strategy en Git (Github o Gitlab)
 - Armado de ambiente de desarrollo (Salesforce)
 - Gestion de proyecto (Github projects, Gitlab projects o Jira).
@@ -20,7 +35,6 @@ En este repo las tareas buscan automatizar o integrar el siguiente tipo gestione
 - Calidad de codigo (PMD)
 - Uso de IA ( OpenAI, )
 
-
 ## Roadmap Status
 
 1. Modelos
@@ -60,19 +74,6 @@ En este repo las tareas buscan automatizar o integrar el siguiente tipo gestione
 
 
 
-## Instalación
-
-```
-yarn add -D autoforce
-```
-
-Chequear instalacion
-
-```
-npx autoforce version
-```
-
-
 ## Usos
 Una vez instalado se puede crear scripts a medida o bien ejecutar 
 

package/commands/modelA/tasks/list.json

@@ -1,6 +1,6 @@
 {
   "name": "list",
-  "guards": ["isGitApi"],
+  "guards": ["isGitApi"],  
   "description": "Comando para ver en detalle el requerimiento",
   "steps": [
     {

package/commands/modelC/new/issue.json

@@ -5,28 +5,11 @@
     "title": { "required": true },
     "label": {
       "type": "select",
-      "choices": [
-        {
-          "title": "Automation",
-          "value": "automation",
-          "description": "Test cases de automatizacion o cualquier cambio dentro de la automatizacion del pipeline"
-        },
-        {
-          "title": "Bugfix",
-          "value": "bug",
-          "description": "Correxion de codigo, no hay incremento funcional"
-        },
-        {
-          "title": "Documentation",
-          "value": "documentation",
-          "description": "Cambios en la documentacion"
-        },
-        {
-          "title": "Feature",
-          "value": "feature",
-          "description": "Nuevas funcionalidades"
-        }
-      ]
+      "values": "labels"
+    },
+    "milestone": {
+      "type": "select",      
+      "values": "milestones"
     },
     "body": { "required": false }    
   },
@@ -35,7 +18,7 @@
     {
       "name": "Crear un issue nuevo",
       "function": "createIssue",
-      "arguments": ["${title}", "${label}", "${body}"]
+      "arguments": ["${title}", "${label}", "${body}", "${milestone}"]
     }
   ]
 }

package/commands/modelC/tasks/list.json

@@ -1,11 +1,13 @@
 {
   "name": "list",
   "guards": ["isGitApi"],
+  "arguments": ["filter", "template"],
   "description": "Comando para ver en detalle el requerimiento",
   "steps": [
     {
       "name": "Ver los issues del Backlog",
-      "function": "listIssues"
+      "function": "listIssues",
+      "arguments": ["${filter}", "${template}"]
     }
   ]
 }

package/commands/modelC/tasks/publish.json

@@ -8,6 +8,7 @@
   "steps": [
     { "name": "Paquetiza", "subtask": "pack" },
     { "name": "Actualiza la version", "function": "storeConfig", "arguments": ["version", "${newVersion}"] },
-    { "name": "Publica", "command": "yarn publish  ", "arguments": {"--new-version": "${newVersion}"} }
+    { "name": "Publica", "command": "yarn publish  ", "arguments": {"--new-version": "${newVersion}"} },
+    { "name": "Salida para el Changelog.md", "task": "list", "arguments": {"filter": "milestone", "template": "changelog", "milestone": "${newVersion}"} }
   ]
 }

package/lib/auto.js

@@ -39,10 +39,10 @@ export default function main() {
                 const taskName = yield askForTaskName(config.taskName, tasks);
                 if (taskName) {
                     const task = tasks[taskName];
-                    const options = config.arguments && task.arguments ? Object.assign(Object.assign({}, config.options), createObject(task.arguments, config.arguments)) : config.options;
+                    context.options = config.arguments && task.arguments ? Object.assign(Object.assign({}, config.options), createObject(task.arguments, config.arguments)) : config.options;
                     // Valida los json de task y subtask
                     if (validateTask(task)) {
-                        yield taskCommand[config.command](task, options);
+                        yield taskCommand[config.command](task, context.options);
                     }
                     else {
                         logError('Verifique que los json de task y subtask esten validos');
@@ -50,7 +50,7 @@ export default function main() {
                 }
             }
             else {
-                yield proxyCommand[config.command]();
+                yield proxyCommand[config.command](config.taskName, config.options);
             }
         }
         catch (error) {

package/lib/helpers/context.d.ts

@@ -1,3 +1,4 @@
+import prompts from "prompts";
 import type { PromptChoices } from "../types/helpers/context.js";
 import type { IProcessHeader, Processes, AnyValue, IProcessInfo, ObjectRecord, IObjectRecord } from "../types/auto.js";
 import type { TaskArguments, TaskArgument, StepArguments } from "../types/helpers/tasks.js";
@@ -6,6 +7,11 @@ export declare enum GitServices {
     GitLab = "gitlab",
     None = "none"
 }
+export declare enum ListFilters {
+    Mios = "mios",
+    PorMilestone = "milestone",
+    PorLabel = "label"
+}
 export declare enum ProjectServices {
     GitHub = "github",
     GitLab = "gitlab",
@@ -20,6 +26,7 @@ declare class Context implements IObjectRecord {
     isGitApi: boolean;
     gitApi: IGitApi | undefined;
     version: string | undefined;
+    options: Record<string, AnyValue>;
     projectServices: ProjectServices;
     isProjectApi: boolean;
     projectApi: IProjectApi | undefined;
@@ -49,7 +56,13 @@ declare class Context implements IObjectRecord {
     repositoryRepo: string | undefined;
     projectId: string | undefined;
     backlogColumn: string;
+    listFilter: ListFilters;
+    listTemplate: string;
     constructor();
+    labels(): Promise<prompts.Choice[]>;
+    listFilters(): prompts.Choice[];
+    milestoneNumbers(): Promise<prompts.Choice[]>;
+    milestones(): Promise<prompts.Choice[]>;
     loadProjectApi(): void;
     loadGitApi(): void;
     loadPackage(): void;
@@ -85,7 +98,7 @@ declare class Context implements IObjectRecord {
     get process(): string | undefined;
     askForprocess(): Promise<any>;
     askFornewIssueType(): Promise<any>;
-    convertToArrayOfInputs(inputs: TaskArguments): TaskArgument[];
+    convertToArrayOfInputs(inputs: TaskArguments): Promise<TaskArgument[]>;
     askForExit(): Promise<void>;
     mergeArgs(args: StepArguments): StepArguments;
     askForArguments(inputs: TaskArguments): Promise<void>;

package/lib/helpers/context.js

@@ -22,6 +22,12 @@ export var GitServices;
     GitServices["GitLab"] = "gitlab";
     GitServices["None"] = "none";
 })(GitServices || (GitServices = {}));
+export var ListFilters;
+(function (ListFilters) {
+    ListFilters["Mios"] = "mios";
+    ListFilters["PorMilestone"] = "milestone";
+    ListFilters["PorLabel"] = "label";
+})(ListFilters || (ListFilters = {}));
 export var ProjectServices;
 (function (ProjectServices) {
     ProjectServices["GitHub"] = "github";
@@ -37,6 +43,7 @@ class Context {
         this.modelTemplates = 'modelA'; // Default Model de templates
         this.gitServices = GitServices.None;
         this.isGitApi = false;
+        this.options = {};
         this.projectServices = ProjectServices.None;
         this.isProjectApi = false;
         this.sfInstalled = true;
@@ -47,9 +54,49 @@ class Context {
         // Ultima salida del shell
         this.salida = '';
         this.backlogColumn = 'Todo';
+        //Templates especiales
+        this.listFilter = ListFilters.Mios;
+        this.listTemplate = 'openIssues';
         this.loadConfig();
         this.loadPackage();
     }
+    labels() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const choices = [{ value: '', title: 'Ninguno' }];
+            const labels = yield ((_a = this.gitApi) === null || _a === void 0 ? void 0 : _a.getLabels());
+            if (labels) {
+                labels.forEach(label => choices.push({ value: label.name, title: label.name }));
+            }
+            return choices;
+        });
+    }
+    listFilters() {
+        const filters = [{ title: 'Solo mios abiertos', value: ListFilters.Mios, description: 'Busca los issues donde este asignado y esten en state Open' }, { title: 'Por Milestone', value: ListFilters.PorMilestone, description: 'Busca los issues de un deterinado milestone' }, { title: 'Por Label', value: ListFilters.PorLabel, description: 'Busca los issues de un deterinado label' }];
+        return filters;
+    }
+    milestoneNumbers() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const choices = [{ value: '', title: 'Ninguno' }];
+            const milestones = yield ((_a = this.gitApi) === null || _a === void 0 ? void 0 : _a.getMilestones());
+            if (milestones) {
+                milestones.forEach(milestone => choices.push({ value: milestone.number, title: milestone.title }));
+            }
+            return choices;
+        });
+    }
+    milestones() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const choices = [{ value: '', title: 'Ninguno' }];
+            const milestones = yield ((_a = this.gitApi) === null || _a === void 0 ? void 0 : _a.getMilestones());
+            if (milestones) {
+                milestones.forEach(milestone => choices.push({ value: milestone.id, title: milestone.title }));
+            }
+            return choices;
+        });
+    }
     loadProjectApi() {
         if (!this.isProjectApi) {
             if (this.projectServices == ProjectServices.GitHub && process.env.GITHUB_TOKEN) {
@@ -369,7 +416,7 @@ class Context {
     askForprocess() {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.projectApi && !this.issueTitle && this.issueNumber) {
-                const issue = yield this.projectApi.getIssueObject(this.issueNumber);
+                const issue = yield this.projectApi.getIssue(this.issueNumber);
                 this.issueTitle = issue.title;
             }
             if (this.issueTitle) {
@@ -405,22 +452,29 @@ class Context {
         });
     }
     convertToArrayOfInputs(inputs) {
-        let inputsArray = [];
-        if (Array.isArray(inputs)) {
-            // Si viene los args como ['name1', 'names] lo convierte a [{name: 'name1'}, {name: 'name2'}]
-            inputsArray = inputs.map(input => { return { name: input, type: 'text', message: `Por favor ingrese ${input}?` }; });
-        }
-        else {
-            // Si viene args como objeto { name1: {...}, name2: {...}} lo convierte a [{name: name1...}, {name: name2...}]
-            for (const key in inputs) {
-                let initial = typeof inputs[key].default == 'string' ? inputs[key].default : undefined;
-                if (initial !== undefined) {
-                    initial = this.merge(initial);
+        return __awaiter(this, void 0, void 0, function* () {
+            let inputsArray = [];
+            if (Array.isArray(inputs)) {
+                // Si viene los args como ['name1', 'names] lo convierte a [{name: 'name1'}, {name: 'name2'}]
+                inputsArray = inputs.map(input => { return { name: input, type: 'text', message: `Por favor ingrese ${input}?` }; });
+            }
+            else {
+                // Si viene args como objeto { name1: {...}, name2: {...}} lo convierte a [{name: name1...}, {name: name2...}]
+                for (const key in inputs) {
+                    if (typeof inputs[key].default == 'string') {
+                        inputs[key].initial = this.merge(inputs[key].default);
+                    }
+                    if (typeof inputs[key].values == 'string' && typeof this[inputs[key].values] == 'function') {
+                        const choices = yield this[inputs[key].values]();
+                        if (Array.isArray(choices)) {
+                            inputs[key].choices = choices;
+                        }
+                    }
+                    inputsArray.push(Object.assign({ name: key, type: 'text', message: `Por favor ingrese ${key}?` }, inputs[key]));
                 }
-                inputsArray.push(Object.assign({ name: key, type: 'text', initial, message: `Por favor ingrese ${key}?` }, inputs[key]));
             }
-        }
-        return inputsArray;
+            return inputsArray;
+        });
     }
     askForExit() {
         return __awaiter(this, void 0, void 0, function* () {
@@ -459,7 +513,7 @@ class Context {
     askForArguments(inputs) {
         return __awaiter(this, void 0, void 0, function* () {
             // unifica los dos tipos de inputs (array y objeto) en un array de inputs
-            const inputsArray = this.convertToArrayOfInputs(inputs);
+            const inputsArray = yield this.convertToArrayOfInputs(inputs);
             for (const input of inputsArray) {
                 const hasValue = yield this.get(input.name);
                 if (!hasValue) {

package/lib/helpers/github-graphql.d.ts

@@ -10,6 +10,8 @@ export declare class GitHubApi implements IGitApi {
         login: string;
         id: number;
     }>;
+    getLabels(): Promise<ILabel[]>;
+    getMilestones(): Promise<IMilestone[]>;
     getRepository(label?: string): Promise<{
         id: string;
         label?: {
@@ -29,39 +31,6 @@ export declare class GitHubApi implements IGitApi {
     }>;
     createPullRequest(branchName: string, title: string, body: string): Promise<boolean>;
     assignBranchToIssue(issueNumber: string, branchName: string, commitSha: string): Promise<boolean>;
-    getIssue(issueNumber: string): Promise<{
-        id: string;
-        title: string;
-        labels: {
-            nodes: {
-                name: string;
-                color: string;
-            }[];
-        };
-        projectItems: {
-            nodes: {
-                id: string;
-                project: {
-                    id: string;
-                };
-                fieldValueByName: {
-                    name: string;
-                    id: string;
-                    field: {
-                        id: string;
-                    };
-                };
-            }[];
-        };
-        linkedBranches: {
-            nodes: {
-                ref: {
-                    id: string;
-                    name: string;
-                };
-            }[];
-        };
-    }>;
     getCommit(commitSha: string): Promise<{
         id: string;
         oid: string;

package/lib/helpers/github-graphql.js

@@ -31,6 +31,45 @@ export class GitHubApi {
             return viewer;
         });
     }
+    getLabels() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const query = `
+        query getRepo($owner:String!, $repo: String! ) {
+          repository(owner: $owner, name: $repo) {
+            labels(last: 10, orderBy:  { field: CREATED_AT, direction: DESC}) {
+              nodes{
+                id
+                name
+                color
+              }
+            }
+          }
+        }
+    `;
+            const { repository } = yield this.graphqlAuth(query, this.repoVar);
+            return repository.labels.nodes;
+        });
+    }
+    getMilestones() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const query = `
+        query getRepo($owner:String!, $repo: String! ) {
+          repository(owner: $owner, name: $repo) {
+            milestones(last: 10, states: OPEN, orderBy: { field: CREATED_AT, direction: DESC} ) {
+              nodes{
+                id
+                number
+                title
+                dueOn
+              }
+            }
+          }
+        }
+    `;
+            const { repository } = yield this.graphqlAuth(query, this.repoVar);
+            return repository.milestones.nodes;
+        });
+    }
     getRepository(label) {
         return __awaiter(this, void 0, void 0, function* () {
             const query = `
@@ -97,7 +136,17 @@ export class GitHubApi {
     assignBranchToIssue(issueNumber, branchName, commitSha) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
-            const issue = yield this.getIssue(issueNumber);
+            const query = `
+        query getIssue($owner:String!, $repo: String!, $issueNumber: Int!) {
+          repository(owner: $owner, name: $repo) {
+            issue(number: $issueNumber) {
+              id
+            }
+          }
+        }
+    `;
+            const { repository } = yield this.graphqlAuth(query, Object.assign({ issueNumber: Number.parseInt(issueNumber) }, this.repoVar));
+            const issue = repository.issue;
             const commit = yield this.getCommit(commitSha);
             const mutation = `
       mutation createLinkedBranch( $issueId: ID!, $oid: GitObjectID!, $branchName: String!) { 
@@ -116,55 +165,6 @@ export class GitHubApi {
             return ((_a = createLinkedBranch === null || createLinkedBranch === void 0 ? void 0 : createLinkedBranch.issue) === null || _a === void 0 ? void 0 : _a.id) ? true : false;
         });
     }
-    getIssue(issueNumber) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const query = `
-      query getIssue($owner:String!, $repo: String!, $issueNumber: Int!) {
-        repository(owner: $owner, name: $repo) {
-          issue(number: $issueNumber) {
-            title
-            id
-            labels(first:3, orderBy:  { field: CREATED_AT, direction: DESC}) {
-              nodes {
-                color
-                name
-              }
-            }
-            projectItems(last: 1) {
-              nodes{
-                id, 
-                project {
-                  id
-                }
-                fieldValueByName(name: "Status"){
-      						... on ProjectV2ItemFieldSingleSelectValue {
-                    name
-                    id
-                    field {
-                      ... on ProjectV2SingleSelectField {
-                        id
-                      }
-                    }
-                  }
-                }
-              }
-            }             
-            linkedBranches(last:1){
-                nodes {
-                    ref {
-                      id
-                      name
-                    }
-                }
-            }
-          }
-        }
-      }
-  `;
-            const { repository } = yield this.graphqlAuth(query, Object.assign({ issueNumber: Number.parseInt(issueNumber) }, this.repoVar));
-            return repository.issue;
-        });
-    }
     getCommit(commitSha) {
         return __awaiter(this, void 0, void 0, function* () {
             const query = `

package/lib/helpers/github-project-graphql.d.ts

@@ -3,15 +3,47 @@ export declare class GitHubProjectApi extends GitHubApi implements IProjectApi {
     projectNumber: number;
     constructor(token: string, owner: string, repo: string, projectNumber: number);
     getColumnValueMap(): Promise<Record<string, string>>;
-    createIssue(title: string, state?: string, label?: string, body?: string, milestone?: string): Promise<number>;
+    createIssue(title: string, state?: string, label?: string, body?: string, milestoneId?: string): Promise<number>;
     getIssueState(issueNumber: string): Promise<string>;
     getIssueName(title: string): string;
-    getIssueObject(issueNumber: string): Promise<IIssueObject>;
-    getIssues(): Promise<{
+    _getIssue(issueNumber: string): Promise<{
+        number: number;
         id: string;
+        body: string;
+        url: string;
         title: string;
-    }[]>;
-    getIssuesByMilestone(milestone: string): Promise<{
+        labels: {
+            nodes: {
+                name: string;
+                color: string;
+            }[];
+        };
+        projectItems: {
+            nodes: {
+                id: string;
+                project: {
+                    id: string;
+                };
+                fieldValueByName: {
+                    name: string;
+                    id: string;
+                    field: {
+                        id: string;
+                    };
+                };
+            }[];
+        };
+        linkedBranches: {
+            nodes: {
+                ref: {
+                    id: string;
+                    name: string;
+                };
+            }[];
+        };
+    }>;
+    getIssue(issueNumber: string): Promise<IIssueObject>;
+    getIssues(): Promise<{
         id: string;
         title: string;
     }[]>;