@ggdna/dna-gg 0.1.0

package/dna/dot-claude/skills/commit/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: commit
+description: Commits the ticket's work in every repo with `gg do commit`. Use when the user says "/commit" or asks to commit the current changes.
+---
+
+# Commit
+
+`gg do commit` runs the checks of each repo and commits only when they are
+green. The message also becomes the `CHANGELOG.md` entry.
+
+## 1. Propose a message
+
+Look at `git status` and `git diff` in the repos of the ticket. Propose one
+imperative one-liner that says what the step does, not which files changed.
+Let the user confirm it.
+
+## 2. Commit
+
+From the ticket folder:
+
+```bash
+gg do commit -m"<message>"
+```
+
+Add `-l` when the message must not land in `CHANGELOG.md`.
+
+## 3. On a failing check
+
+`gg do commit` stops at the first red check. Fix the cause, never the check,
+then run the command again. Files generated by the DNA are committed
+separately as `#gg: generated DNA` — never edit an instance by hand, change
+its source under `dna/` instead.
+
+## Important
+
+- Never commit without the confirmed message.
+- Never push here — that is `/push`.

package/dna/dot-claude/skills/publish/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: publish
+description: Prepares the release of a reviewed ticket and hands `gg do publish` over to the user. Use when the user says "/publish" or asks to release the ticket.
+---
+
+# Publish
+
+`gg do publish` merges the pull requests, publishes to the registry and
+creates and pushes the version tags. It is interactive — the user runs it.
+
+## 1. Check the preconditions
+
+- Every repo of the ticket is committed and pushed.
+- The pull requests created by `gg do review` are green.
+
+## 2. Configure the publish
+
+```bash
+gg do configure-publish
+```
+
+Check per repo that the version bump matches what the ticket changed and
+that `CHANGELOG.md` reads well.
+
+## 3. Let the user publish
+
+Ask the user to run this **manually** from the ticket folder:
+
+```bash
+gg do publish
+```
+
+It asks whether the ticket and the remote feature branches may be deleted.
+If the user declines, run `/cleanup` afterwards.
+
+## Important
+
+- Never run `gg do publish` yourself.
+- Never write versions or tags by hand.

package/dna/dot-claude/skills/push/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: push
+description: Pushes the ticket's commits with `gg do push`. Use when the user says "/push" or asks to push the current ticket.
+---
+
+# Push
+
+From the ticket folder:
+
+```bash
+gg do push
+```
+
+`gg do push` pushes the repos of the ticket in dependency order and refuses
+repos that still carry uncommitted work. If it reports such a repo, run
+`/commit` first and push again.
+
+## Important
+
+- Push only when the user asked for it.
+- Do not create pull requests here — `gg do review` does that.

package/dna/dot-claude/skills/ticket/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: ticket
+description: Creates a gg ticket and adds the repos it needs. Use when the user says "/ticket", "new ticket", "fix bug X", or "implement feature Y".
+---
+
+# Create a ticket
+
+All `gg do` commands run inside the workspace. Ask for the workspace
+directory if none is known.
+
+## 1. Ask for the ticket data
+
+- Ticket ID, e.g. `DnaJiraPrefix-145`
+- Title, one imperative line, e.g. `Fix issue abc`
+
+## 2. Create the ticket
+
+```bash
+cd ~/dev/ # workspace
+gg do create ticket DnaJiraPrefix-145 -m"Fix issue abc"
+cd tickets/DnaJiraPrefix-145
+```
+
+## 3. Choose the repos
+
+Read the `index.md` of the candidate repos in `.ocean`. Tell the user which
+repos the ticket needs and what you roughly want to change in each one. If a
+part belongs to a domain that has no repo yet, say so and ask whether to
+create one.
+
+After the confirmation:
+
+```bash
+gg do add repo1 repo2
+```
+
+## 4. Open the workspace
+
+```bash
+gg do code
+```
+
+## Important
+
+- Never add repos without confirmation. Rather too few than too many — more
+  can be added later.
+- Do not start the implementation unasked.

package/dna/dot-github/workflows/quick_check.yaml

@@ -0,0 +1,20 @@
+# Runs the gg-js quick check on every push and pull request against main.
+
+name: Tests
+
+on:
+  push:
+    branches: ['main']
+  pull_request:
+    branches: ['main']
+
+jobs:
+  build:
+    name: dnaGitQuickCheckPipelineName
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v5
+
+      # Uses the Node.js preinstalled on the runner image.
+      - run: npx @tssuite/gg-js one did commit

package/dna/scripts/delete-feature-branch.js

@@ -0,0 +1,97 @@
+/**
+ * @license
+ * Copyright (c) ggsuite
+ *
+ * Use of this source code is governed by terms that can be
+ * found in the LICENSE file in the root of this package.
+ */
+
+import { gray, green, red, yellow } from './functions/colors.js';
+import { runCommand } from './functions/run-command.js';
+
+// Check for uncommitted changes
+function hasUncommittedChanges() {
+  console.log(gray('Check for uncommitted changes'));
+  const status = runCommand('git status --porcelain');
+  return status.length > 0;
+}
+
+// Check for unpushed commits
+function hasUnpushedCommits(branch) {
+  try {
+    console.log(gray('Check for unpushed commits'));
+    runCommand(`git rev-parse --abbrev-ref ${branch}@{u}`);
+    const ahead = runCommand(`git rev-list --count ${branch}@{u}..${branch}`);
+    return parseInt(ahead, 10) > 0;
+  } catch {
+    return true;
+  }
+}
+
+// Try a test merge into main and check if it introduces changes
+function isBranchEffectivelyMerged(featureBranch) {
+  console.log(gray('Check if feature was fully merged'));
+
+  try {
+    runCommand(`git merge --no-commit --no-ff ${featureBranch}`);
+    const changed = hasUncommittedChanges();
+    runCommand('git merge --abort');
+    return !changed;
+  } catch {
+    try {
+      runCommand('git merge --abort');
+    } catch {}
+    return false;
+  }
+}
+
+try {
+  console.log(gray('Get current branch name'));
+  const currentBranch = runCommand('git rev-parse --abbrev-ref HEAD');
+
+  if (currentBranch === 'main') {
+    console.log(yellow('Please call this script from a feature branch.'));
+    process.exit(0);
+  }
+
+  if (hasUncommittedChanges()) {
+    console.error(red('❌ You have uncommitted changes.'));
+    console.error(
+      yellow('Please commit or stash your changes before continuing.'),
+    );
+    process.exit(1);
+  }
+
+  if (hasUnpushedCommits(currentBranch)) {
+    console.error(red('❌ You have unpushed commits.'));
+    console.error(yellow('Please push your branch before continuing.'));
+    process.exit(1);
+  }
+
+  console.log(gray(`Fetching and pulling 'main'...`));
+  runCommand('git fetch');
+  runCommand('git checkout main');
+  runCommand('git pull origin main');
+
+  const isMerged = isBranchEffectivelyMerged(currentBranch);
+
+  if (isMerged) {
+    runCommand(`git branch -d ${currentBranch}`);
+    console.log(green(`✅ Branch '${currentBranch}' has been deleted.`));
+  } else {
+    console.error(
+      red(`❌ Branch '${currentBranch}' is not merged into 'main'.`),
+    );
+    console.log(
+      yellow(`Please (create and) merge a pull request and try again.`),
+    );
+    runCommand(`git checkout ${currentBranch}`);
+    console.log(gray(`Switched back to '${currentBranch}'.`));
+  }
+} catch (error) {
+  console.error(red(`Error: ${error.message}`));
+  try {
+    runCommand('git merge --abort');
+  } catch {}
+  process.exit(1);
+}

package/dna/scripts/functions/colors.js

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright (c) ggsuite
+ *
+ * Use of this source code is governed by terms that can be
+ * found in the LICENSE file in the root of this package.
+ */
+
+export const red = (str) => `\x1b[31m${str}\x1b[0m`;
+export const green = (str) => `\x1b[32m${str}\x1b[0m`;
+export const yellow = (str) => `\x1b[33m${str}\x1b[0m`;
+export const blue = (str) => `\x1b[34m${str}\x1b[0m`;
+export const magenta = (str) => `\x1b[35m${str}\x1b[0m`;
+export const cyan = (str) => `\x1b[36m${str}\x1b[0m`;
+export const white = (str) => `\x1b[37m${str}\x1b[0m`;
+export const black = (str) => `\x1b[30m${str}\x1b[0m`;
+export const bgRed = (str) => `\x1b[41m${str}\x1b[0m`;
+export const bgGreen = (str) => `\x1b[42m${str}\x1b[0m`;
+export const bgYellow = (str) => `\x1b[43m${str}\x1b[0m`;
+export const bgBlue = (str) => `\x1b[44m${str}\x1b[0m`;
+export const bgMagenta = (str) => `\x1b[45m${str}\x1b[0m`;
+export const bgCyan = (str) => `\x1b[46m${str}\x1b[0m`;
+export const bgWhite = (str) => `\x1b[47m${str}\x1b[0m`;
+export const bgBlack = (str) => `\x1b[40m${str}\x1b[0m`;
+export const gray = (str) => `\x1b[90m${str}\x1b[0m`;
+export const lightGray = (str) => `\x1b[37m${str}\x1b[0m`;
+export const reset = (str) => `\x1b[0m${str}\x1b[0m`;

package/dna/scripts/functions/current-branch.js

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright (c) ggsuite
+ *
+ * Use of this source code is governed by terms that can be
+ * found in the LICENSE file in the root of this package.
+ */
+
+export const currentBranch = () => {
+  return execSync('git rev-parse --abbrev-ref HEAD').toString().trim();
+};

package/dna/scripts/functions/directories.js

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright (c) ggsuite
+ *
+ * Use of this source code is governed by terms that can be
+ * found in the LICENSE file in the root of this package.
+ */
+
+// Get the name of this file
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+export const workSpaceDir = join(__dirname, '..', '..');
+export const distDir = join(workSpaceDir, 'dist');
+export const srcDir = join(workSpaceDir, 'src');
+export const testDir = join(workSpaceDir, 'test');
+export const scriptsDir = join(workSpaceDir, 'scripts');
+export const goldensDir = join(testDir, 'goldens');
+export const nodeModulesDir = join(workSpaceDir, 'node_modules');

package/dna/scripts/functions/get-repo-urls.js

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright (c) ggsuite
+ *
+ * Use of this source code is governed by terms that can be
+ * found in the LICENSE file in the root of this package.
+ */
+
+// Import Node.js built-in module for working with child processes
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { green, yellow } from './colors.js';
+
+// Convert exec to return a Promise for async/await usage
+const execAsync = promisify(exec);
+
+// GitHub organization or user
+const org = 'rljson';
+
+export async function getRepoUrls() {
+  try {
+    // Use the GitHub CLI to list repositories in JSON format
+    const { stdout } = await execAsync(
+      `gh repo list ${org} --limit 1000 --json url`,
+    );
+
+    // Parse the JSON output
+    const repos = JSON.parse(stdout);
+
+    // Map to name + URL and print to console
+    return repos.map((repo) => repo.url);
+  } catch (error) {
+    if (error.message.match('gh auth login').length == 1) {
+      throw Error(
+        [yellow('Not yet logged in. Please run:'), green('gh auth login')].join(
+          '\n',
+        ),
+      );
+    }
+
+    throw error;
+  }
+}

package/dna/scripts/functions/get-version.js

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright (c) ggsuite
+ *
+ * Use of this source code is governed by terms that can be
+ * found in the LICENSE file in the root of this package.
+ */
+
+import { readFile } from 'fs/promises';
+
+export const getVersion = async () => {
+  const packageJson = JSON.parse(await readFile('package.json', 'utf8'));
+  return packageJson.version;
+};

package/dna/scripts/functions/is-clean-repo.js

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright (c) ggsuite
+ *
+ * Use of this source code is governed by terms that can be
+ * found in the LICENSE file in the root of this package.
+ */
+
+// checkRepo.js
+import { execSync } from 'child_process';
+
+export function isCleanRepo(path) {
+  const cwd = path ?? '.';
+
+  try {
+    // Aktuellen Branch ermitteln
+    const branch = execSync('git rev-parse --abbrev-ref HEAD', {
+      cwd,
+    })
+      .toString()
+      .trim();
+    if (branch !== 'main') {
+      return false;
+    }
+
+    // Git-Fetch ausführen (still)
+    execSync('git fetch', { stdio: 'ignore', cwd });
+
+    // Prüfen, ob Arbeitsverzeichnis sauber ist
+    const status = execSync('git status --porcelain', { cwd })
+      .toString()
+      .trim();
+    if (status.length > 0) {
+      return false;
+    }
+
+    // Prüfen, ob main auf dem neuesten Stand mit origin/main ist
+    const revList = execSync(
+      'git rev-list --left-right --count origin/main...main',
+      { cwd },
+    )
+      .toString()
+      .trim();
+
+    const [behind, ahead] = revList.split('\t').map(Number);
+    return behind === 0 && ahead === 0;
+  } catch (err) {
+    console.error('Git error:', err.message);
+    return false;
+  }
+}

package/dna/scripts/functions/is-main-up-to-date.js

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright (c) ggsuite
+ *
+ * Use of this source code is governed by terms that can be
+ * found in the LICENSE file in the root of this package.
+ */
+
+export const isMainUpToDate = () => {
+  try {
+    execSync('git fetch origin main');
+    const localHash = execSync('git rev-parse main').toString().trim();
+    const remoteHash = execSync('git rev-parse origin/main').toString().trim();
+    return localHash === remoteHash;
+  } catch (error) {
+    console.error(red('Error checking branch status:'), error);
+    return false;
+  }
+};

package/dna/scripts/functions/pull-request-url.js

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright (c) ggsuite
+ *
+ * Use of this source code is governed by terms that can be
+ * found in the LICENSE file in the root of this package.
+ */
+
+export function pullRequestUrl() {
+  const json = execSync('gh pr view --json url', {
+    encoding: 'utf-8',
+  }).trim();
+
+  const parsed = JSON.parse(json);
+  const url = parsed.url;
+  return url;
+}

package/dna/scripts/functions/run-command.js

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright (c) ggsuite
+ *
+ * Use of this source code is governed by terms that can be
+ * found in the LICENSE file in the root of this package.
+ */
+
+import { execSync } from 'child_process';
+import { gray } from './colors.js';
+
+// Execute a shell command and return trimmed output
+// Execute a shell command and return trimmed output
+export function runCommand(command, silent = true, logCommand = true) {
+  if (logCommand) {
+    console.log(gray(`${command}`));
+  }
+  return execSync(command, {
+    encoding: 'utf-8',
+    stdio: silent ? ['pipe', 'pipe', 'pipe'] : undefined,
+  }).trim();
+}

package/dna/scripts/functions/sync-folders.js

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright (c) ggsuite
+ *
+ * Use of this source code is governed by terms that can be
+ * found in the LICENSE file in the root of this package.
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+
+// Create a node.js script that recursively copies all files from one folder
+// to another
+
+export async function syncFolders(
+  source,
+  target,
+  options = { excludeHidden: true },
+) {
+  if (!fs.existsSync(source)) {
+    console.error(`Source folder "${source}" does not exist.`);
+    return;
+  }
+
+  if (!fs.existsSync(target)) {
+    await fs.promises.mkdir(target, { recursive: true });
+  }
+
+  const items = await fs.promises.readdir(source);
+
+  for (const item of items) {
+    if (options.excludeHidden && item.startsWith('.')) {
+      continue; // Skip hidden files and folders
+    }
+
+    const sourcePath = path.join(source, item);
+    const targetPath = path.join(target, item);
+
+    const stat = await fs.promises.lstat(sourcePath);
+    if (stat.isDirectory()) {
+      await syncFolders(sourcePath, targetPath, options.excludeHidden);
+    } else {
+      await fs.promises.copyFile(sourcePath, targetPath);
+    }
+  }
+}