refactor: migrate Markdown to AsciiDoc

CODE_OF_CONDUCT.adoc

@@ -0,0 +1,24 @@
+== Contributor Covenant Code of Conduct
+
+=== Our Pledge
+
+We pledge to make participation a harassment-free experience for
+everyone.
+
+=== Our Standards
+
+*Positive behavior:* * Using welcoming language * Being respectful of
+differing viewpoints * Accepting constructive criticism * Focusing on
+what is best for the community
+
+*Unacceptable behavior:* * Harassment, trolling, or personal attacks *
+Publishing private information without permission
+
+=== Enforcement
+
+Report issues to the maintainers. All complaints will be reviewed.
+
+=== Attribution
+
+Adapted from https://www.contributor-covenant.org/[Contributor Covenant]
+v2.1.

SECURITY.adoc

@@ -0,0 +1,24 @@
+== Security Policy
+
+=== Supported Versions
+
+[cols=",",options="header",]
+|===
+|Version |Supported
+|main |:white_check_mark:
+|< main |:x:
+|===
+
+=== Reporting a Vulnerability
+
+Please report security vulnerabilities through GitHub private
+vulnerability reporting: 1. Go to the *Security* tab 2. Click *Report a
+vulnerability* 3. Fill out the form
+
+We respond within 48 hours.
+
+=== Security Measures
+
+* Dependabot for dependency updates
+* CodeQL for code scanning
+* Secret scanning and push protection

integrations/gittyup/README.adoc

@@ -0,0 +1,67 @@
+== SPDX-License-Identifier: MPL-2.0-or-later
+
+image:https://img.shields.io/badge/License-MPL_2.0-blue.svg[MPL-2.0-or-later,link="`https://opensource.org/licenses/MPL-2.0`"]
+
+== Gittyup Integration for bitfuckit
+
+https://github.com/Murmele/Gittyup[Gittyup] is a Qt-based Git GUI.
+
+=== Current Status
+
+Gittyup doesn’t have a formal plugin API yet, but we can integrate via:
+
+[arabic]
+. *Custom Tools Menu* - Add external tool definitions
+. *Git Hooks* - Triggered on Git operations
+
+=== Custom Tools Setup
+
+Gittyup uses `+~/.config/gittyup/tools.json+` for custom tools:
+
+[source,json]
+----
+{
+  "tools": [
+    {
+      "name": "Bitbucket: Create PR",
+      "command": "bitfuckit",
+      "arguments": ["pr", "create", "--branch", "$BRANCH"],
+      "workdir": "$REPO_PATH"
+    },
+    {
+      "name": "Bitbucket: List PRs",
+      "command": "bitfuckit",
+      "arguments": ["pr", "list"],
+      "workdir": "$REPO_PATH"
+    },
+    {
+      "name": "Bitbucket: Mirror",
+      "command": "bitfuckit",
+      "arguments": ["mirror"],
+      "workdir": "$REPO_PATH"
+    },
+    {
+      "name": "Bitbucket: Pipeline Status",
+      "command": "bitfuckit",
+      "arguments": ["pipeline", "status"],
+      "workdir": "$REPO_PATH"
+    }
+  ]
+}
+----
+
+=== Installation
+
+[source,bash]
+----
+mkdir -p ~/.config/gittyup
+cp tools.json ~/.config/gittyup/
+----
+
+=== Future
+
+We’re tracking the Gittyup project for proper plugin API support.
+
+When available, a full Qt plugin will be developed providing: - Native
+UI integration - Real-time pipeline status - PR review inline - Issue
+linking

scripts/git-private-farm/README.md → scripts/git-private-farm/README.adoc

@@ -1,13 +1,12 @@
-# .git-private-farm
-image:https://img.shields.io/badge/License-MPL_2.0-blue.svg[MPL-2.0-or-later,link="https://opensource.org/licenses/MPL-2.0"]
-
+== .git-private-farm
 
+image:https://img.shields.io/badge/License-MPL_2.0-blue.svg[MPL-2.0-or-later,link="`https://opensource.org/licenses/MPL-2.0`"]
 
 Private orchestration hub for rapid multi-forge propagation.
 
-## Architecture
+=== Architecture
 
-```
+....
 ┌──────────────────────────────────────────────────────────────────┐
 │                    .git-private-farm (GitHub Private)            │
 │  ┌────────────────────────────────────────────────────────────┐  │
@@ -32,53 +31,60 @@ Private orchestration hub for rapid multi-forge propagation.
          └───────────────────────┴───────────────────────┘
                          All run in parallel
                        (~5-10 seconds total)
-```
+....
+
+=== Rapid Propagation Modes
 
-## Rapid Propagation Modes
+==== 1. Instant Push (All Forges)
 
-### 1. Instant Push (All Forges)
 Triggered on every push to a repo. Propagates to all configured forges.
 
-```bash
+[source,bash]
+----
 # From any repo with the webhook configured
 git push origin main  # Automatically triggers propagation
-```
+----
+
+==== 2. Selective Push (Specific Forges)
 
-### 2. Selective Push (Specific Forges)
 Use workflow dispatch to push to specific forges only.
 
-```bash
+[source,bash]
+----
 gh workflow run propagate.yml \
   -f repo=bitfuckit \
   -f forges="gitlab,codeberg" \
   --repo hyperpolymath/.git-private-farm
-```
+----
+
+==== 3. Batch Push (All Repos)
 
-### 3. Batch Push (All Repos)
 Propagate all repos to all forges at once.
 
-```bash
+[source,bash]
+----
 gh workflow run batch-propagate.yml \
   --repo hyperpolymath/.git-private-farm
-```
-
-## Setup
-
-1. Create the private repo:
-   ```bash
-   gh repo create .git-private-farm --private
-   ```
-
-2. Add secrets for each forge:
-   - `GITLAB_SSH_KEY`
-   - `SOURCEHUT_SSH_KEY`
-   - `CODEBERG_SSH_KEY`
-   - `BITBUCKET_SSH_KEY`
-
-3. Configure webhooks on source repos to trigger `repository_dispatch`
-
-## Security
-
-- This repo is PRIVATE - contains SSH keys and forge credentials
-- Uses encrypted secrets, never commits raw keys
-- Audit log tracks all propagation events
+----
+
+=== Setup
+
+[arabic]
+. Create the private repo:
++
+[source,bash]
+----
+gh repo create .git-private-farm --private
+----
+. Add secrets for each forge:
+* `+GITLAB_SSH_KEY+`
+* `+SOURCEHUT_SSH_KEY+`
+* `+CODEBERG_SSH_KEY+`
+* `+BITBUCKET_SSH_KEY+`
+. Configure webhooks on source repos to trigger `+repository_dispatch+`
+
+=== Security
+
+* This repo is PRIVATE - contains SSH keys and forge credentials
+* Uses encrypted secrets, never commits raw keys
+* Audit log tracks all propagation events