v4.12.0.0 – Codex-Assisted Refactor, UX Fixes, Gender Parsing, and Test Expansion

.gitignore

@@ -1,2 +1,5 @@
+node_modules/
+*.log
 example*
-.*
+.*
+dist/

AGENTS.md

@@ -0,0 +1,14 @@
+# Developer Guidelines
+
+This repository uses Node.js for development.
+
+## Style
+- Use 4 spaces for indentation.
+- End statements with semicolons.
+
+## Workflow
+1. Run `npm install` to install dependencies.
+2. Run `npm test` before committing to ensure the test suite passes.
+3. Use descriptive commit messages and open pull requests against the main branch.
+
+Testing is handled by Jest; tests live under the `tests` directory.

README.md

@@ -1,3 +1,34 @@
-SmartCopy assists users in copying and updating genealogical information within Geni. It also provides consistency checking on profiles, as well as quick access to research links and the HistoryLink tools.  This tool does not grant permission to use copyrighted content - users are responsible for obtaining any required authorization from the creator of works, such as biographical stories or images.
+# SmartCopy
 
-This software uses the Geni API but is not operated or sponsored by Geni, Inc.
+SmartCopy is a Chrome extension that copies genealogical information from sites like Ancestry and FamilySearch into Geni. It also performs consistency checks and provides quick access to research tools. This software uses the Geni API but is not operated or sponsored by Geni, Inc. Users are responsible for ensuring they have permission to use any copyrighted content.
+
+## Installation
+
+1. Install Node.js (v18 or later).
+2. Clone this repository and install dependencies:
+   ```bash
+   npm install
+   ```
+3. Run the test suite:
+   ```bash
+   npm test
+   ```
+4. Build the extension for loading in Chrome:
+   ```bash
+   npm run build
+   ```
+
+## Loading the Extension
+
+1. Open Chrome and navigate to `chrome://extensions`.
+2. Enable **Developer mode**.
+3. Click **Load unpacked** and select the `dist` directory created by the build step.
+4. The SmartCopy icon will appear in the toolbar.
+
+## Usage
+
+Navigate to a supported genealogy website and click the SmartCopy icon. Follow the prompts to copy data into Geni. Verbose logging can be enabled by setting `verboselogs` to `true` in `popup.js`, though this is disabled by default to avoid exposing sensitive tokens. 
+
+## Contributing
+
+Contributions are welcome. Please review `AGENTS.md` for development guidelines. Use four spaces for indentation and terminate statements with semicolons. All pull requests should include a brief description of changes and must pass the test suite with `npm test`.

background.js

@@ -188,4 +188,4 @@ function delay(ms){
     while(dateNow<currDate+ms){
       dateNow = new Date().getTime();
     }
-}
+}