Initial Dev.

.github/workflows/changelog.yml

@@ -0,0 +1,40 @@
+name: Generate Changelog
+
+permissions:
+  contents: write
+
+on:
+  push:
+    branches-ignore:
+      - main
+
+jobs:
+  changelog:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Generate CHANGELOG.md
+        run: npm run changelog
+
+      - name: Commit CHANGELOG.md
+        run: |
+          git config user.name "github-actions"
+          git config user.email "github-actions@github.com"
+
+          git add CHANGELOG.md
+          git diff --cached --quiet || git commit -m "chore(changelog): update changelog"
+
+          git push

.github/workflows/release.yml

@@ -0,0 +1,72 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Read version from package.json
+        id: version
+        run: |
+          VERSION=$(node -p "require('./package.json').version")
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Check if tag already exists
+        id: tag
+        run: |
+          if git rev-parse "v${{ steps.version.outputs.version }}" >/dev/null 2>&1; then
+            echo "exists=true" >> $GITHUB_OUTPUT
+          else
+            echo "exists=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Stop if release already exists
+        if: steps.tag.outputs.exists == 'true'
+        run: |
+          echo "Release v${{ steps.version.outputs.version }} already exists. Skipping."
+          exit 0
+
+      - name: Generate CHANGELOG
+        run: npm run changelog
+
+      - name: Commit CHANGELOG
+        run: |
+          git config user.name "github-actions"
+          git config user.email "github-actions@github.com"
+          git add CHANGELOG.md
+          git commit -m "chore(changelog): release v${{ steps.version.outputs.version }}" || echo "No changes"
+
+      - name: Push changelog commit
+        run: git push
+
+      - name: Create tag
+        run: |
+          git tag v${{ steps.version.outputs.version }}
+          git push origin v${{ steps.version.outputs.version }}
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ steps.version.outputs.version }}
+          generate_release_notes: true

.github/workflows/validate-version-pr.yml

@@ -0,0 +1,54 @@
+name: Validate version
+
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    branches:
+      - '**.x'
+jobs:
+  validate-version:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Validate package.json version against branch
+        run: |
+          SOURCE_BRANCH="${{ github.head_ref }}"
+          PACKAGE_VERSION=$(node -p "require('./package.json').version")
+
+          echo ""
+          echo "🔍 Version validation"
+          echo "----------------------"
+          echo "Source branch: $SOURCE_BRANCH"
+          echo "package.json version: $PACKAGE_VERSION"
+          echo ""
+
+          # Extract expected major.minor from branch (e.g. 1.2.x -> 1.2)
+          EXPECTED_PREFIX=$(echo "$SOURCE_BRANCH" | sed 's/\.x//')
+
+          if [[ "$PACKAGE_VERSION" != "$EXPECTED_PREFIX"* ]]; then
+            echo "❌ Version validation failed"
+            echo ""
+            echo "Expected package.json version to start with:"
+            echo "  - $EXPECTED_PREFIX."
+            echo ""
+            echo "Found:"
+            echo "  - version: $PACKAGE_VERSION"
+            echo ""
+            echo "🛠️ Please fix the following:"
+            echo "  - Update the version in package.json to match the current branch version you are working on"
+            echo ""
+            echo "💡 As well as the package and branch version, be sure to check the code version published in NPM to follow a correct sequence."
+            exit 1
+          fi
+
+          echo "✅ Version validation passed"

.gitignore

@@ -0,0 +1,2 @@
+node_modules/
+package-lock.json

CHANGELOG.md

@@ -0,0 +1,30 @@
+<a name="1.0.0"></a>
+# 1.0.0 (2025-12-22)
+
+### cli
+| Commit | Type | Description |
+|--------|------|-------------|
+| [c6e6047](https://github.com/DIGOARTHUR/github-automated-repos-cli/commit/c6e60477c5eca20e009e4c052afa6b90bbf08e21) | feat | add prompts-based overwrite options and support for creating alternative project files |
+| [52780d8](https://github.com/DIGOARTHUR/github-automated-repos-cli/commit/52780d83456d14506e87d6517203c085afa68a52) | feat | integrate ora loading spinner for setup steps |
+
+
+### page
+| Commit | Type | Description |
+|--------|------|-------------|
+| [0e934f9](https://github.com/DIGOARTHUR/github-automated-repos-cli/commit/0e934f945abafc55d5c2fd97996dd8a6e26cbeba) | feat | add structions cards: icons, topics, explain (WIP) |
+| [104b7fd](https://github.com/DIGOARTHUR/github-automated-repos-cli/commit/104b7fd867a1590d6e1a49dfa3a5542c7012e4a6) | feat | implement page vitejs example |
+
+
+### vite-template
+| Commit | Type | Description |
+|--------|------|-------------|
+| [b4870e1](https://github.com/DIGOARTHUR/github-automated-repos-cli/commit/b4870e1cddadc9fbc23edd14bf848fb42f6454dc) | fix | replace static username and keyword with dynamic placeholders |
+
+
+### general
+| Commit | Type | Description |
+|--------|------|-------------|
+| [d30acd8](https://github.com/DIGOARTHUR/github-automated-repos-cli/commit/d30acd832144816168a914a5c36d61e11bb101c6) | feat | build example page |
+| [2234519](https://github.com/DIGOARTHUR/github-automated-repos-cli/commit/223451939421eb7185d48f99fe5890e817697221) | feat | implement an interactive command to enter GitHub Username and Keyword |
+
+

bin/index.js

@@ -1,41 +1,29 @@
 #!/usr/bin/env node
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-const args = process.argv.slice(2);
-const framework = args[0] || "next";
-
-if (!["next", "react", "vite"].includes(framework)) {
-  console.log("Uso: npx github-automated-repos-example [next|react|vite]");
-  process.exit(1);
-}
-
-console.log(`🚀 Gerando exemplo para ${framework}...`);
-
-let sourceDir;
-let targetDir;
-
-switch (framework) {
-  case "next":
-    sourceDir = path.join(__dirname, "../examples/nextjs/page.tsx");
-    targetDir = path.join(process.cwd(), "src/app/projects/page.tsx");
-    break;
-  case "react":
-    sourceDir = path.join(__dirname, "../examples/react/Project.jsx");
-    targetDir = path.join(process.cwd(), "src/components/Project.jsx");
-    break;
-  case "vite":
-    sourceDir = path.join(__dirname, "../examples/vite/Project.tsx");
-    targetDir = path.join(process.cwd(), "src/components/Project.tsx");
-    break;
-}
-
-fs.mkdirSync(path.dirname(targetDir), { recursive: true });
-
-fs.copyFileSync(sourceDir, targetDir);
-console.log(`✅ Exemplo criado em: ${targetDir}`);
-console.log("💡 Agora você pode acessar a página no seu projeto Next.js em /projects");
+import { Command } from "commander";
+import chalk from "chalk";
+import initCommand from "../commands/init.js";
+
+const program = new Command();
+
+program
+  .name("github-automated-repos-cli")
+  .description("CLI oficial do github-automated-repos (only init)")
+  .version("1.0.0");
+
+program
+  .command("init")
+  .description("Initialize the project: ensure dependency, install if needed and add example page/component")
+  .option("-y, --yes", "auto-confirm prompts (non-interactive)")
+  .action((opts) => {
+    initCommand
+      .run(opts)
+      .then(() => {
+        console.log(chalk.green("Init finished successfully."));
+      })
+      .catch((err) => {
+        console.error(chalk.red("Init failed:"), err.message || err);
+        process.exit(1);
+      });
+  });
+
+program.parse(process.argv);

changelog-config.cjs

@@ -0,0 +1,107 @@
+module.exports = {
+  preset: "angular",
+  writerOpts: {
+    transform: (commit) => {
+      if (!commit.hash) return null;
+
+      // 🔑 Only user-relevant changes
+      const allowedTypes = ["feat", "fix"];
+
+      const knownScopes = [
+        "cli",
+        "init",
+        "commands",
+        "interactive",
+        "utils",
+        "projectFile",
+        "pkgManager",
+        "framework",
+        "bin",
+        "pageExample",
+        "page",
+        "vite-template",
+        "next-template",
+        "github-actions",
+        "general",
+      ];
+
+
+      if (!allowedTypes.includes(commit.type)) {
+        return null;
+      }
+
+      const shortHash = commit.hash.substring(0, 7);
+      const hashLink =
+        `https://github.com/DIGOARTHUR/github-automated-repos-cli/commit/${commit.hash}`;
+
+      let normalizedScope = commit.scope;
+
+      if (normalizedScope) {
+        normalizedScope = normalizedScope
+          .replace(/files?/i, "projectFile")
+          .replace(/project[-_]?file/i, "projectFile")
+          .replace(/pkg[-_]?manager/i, "pkgManager")
+          .replace(/framework/i, "framework")
+          .replace(/interactive/i, "interactive")
+          .replace(/commands?/i, "commands")
+          .replace(/utils?/i, "utils")
+          .replace(/bin/i, "bin")
+          .replace(/init/i, "init")
+          .replace(/cli/i, "cli")
+          .replace(/page[-_]?example/i, "pageExample")
+          .replace(/vite[-_]?template/i, "vite-template")
+          .replace(/next[-_]?template/i, "next-template")
+          .replace(/github[-_]?actions?/i, "github-actions");
+      }
+
+      if (!normalizedScope || !knownScopes.includes(normalizedScope)) {
+        normalizedScope = "general";
+      }
+
+      return {
+        ...commit,
+        scope: normalizedScope,
+        shortHash,
+        hashLink,
+      };
+    },
+
+    groupBy: "scope",
+
+    commitGroupsSort: (a, b) => {
+      const order = [
+        "cli",
+        "init",
+        "commands",
+        "interactive",
+        "projectFile",
+        "utils",
+        "pkgManager",
+        "framework",
+        "pageExample",
+        "page",
+        "vite-template",
+        "next-template",
+        "general",
+      ];
+      return order.indexOf(a.title) - order.indexOf(b.title);
+    },
+
+    commitsSort: ["type", "subject"],
+
+    headerPartial:
+      '<a name="{{version}}"></a>\n# {{version}} ({{date}})\n\n',
+
+    commitPartial:
+      "| [{{shortHash}}]({{hashLink}}) | {{type}} | {{subject}} |\n",
+
+    mainTemplate: `{{> header}}
+{{#each commitGroups}}
+### {{title}}
+| Commit | Type | Description |
+|--------|------|-------------|
+{{#each commits}}{{> commit}}{{/each}}
+
+{{/each}}`,
+  },
+};