awarts 0.2.9 → 0.3.1

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,27 @@
+# Code of Conduct
+
+## Our Pledge
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+**Positive behavior includes:**
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+
+**Unacceptable behavior includes:**
+- Trolling, insulting comments, and personal attacks
+- Harassment in any form
+- Publishing others' private information without permission
+- Other conduct which could reasonably be considered inappropriate
+
+## Enforcement
+
+Instances of abusive or unacceptable behavior may be reported by opening an issue or contacting the maintainer. All complaints will be reviewed and investigated.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.

package/CONTRIBUTING.md

@@ -0,0 +1,66 @@
+# Contributing to AWARTS CLI
+
+Thanks for your interest in contributing to AWARTS! Here's how to get started.
+
+## Development Setup
+
+1. Clone the repo:
+   ```bash
+   git clone https://github.com/HarshalJain-cs/AWARTS.git
+   cd AWARTS/cli
+   ```
+
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+3. Run in dev mode:
+   ```bash
+   npm run dev
+   ```
+
+## Project Structure
+
+```
+cli/
+  src/
+    index.ts          # CLI entry point (commander setup)
+    types.ts          # Shared TypeScript types
+    adapters/         # Provider adapters (claude, codex, gemini, antigravity)
+    commands/         # Command implementations
+    lib/              # Core libraries (auth, daemon, api, output)
+  dist/               # Built output
+  package.json
+```
+
+## Adding a New Provider Adapter
+
+1. Create `src/adapters/<provider>.ts` implementing the `Adapter` interface:
+   ```typescript
+   interface Adapter {
+     name: ProviderKey;
+     displayName: string;
+     detect(): Promise<boolean>;
+     read(): Promise<UsageEntry[]>;
+   }
+   ```
+
+2. Register it in `src/lib/detect.ts`
+
+3. Test with `awarts push --provider <name> --dry-run`
+
+## Guidelines
+
+- Write clear commit messages
+- Keep PRs focused on a single change
+- Test your changes locally before submitting
+- Don't commit API keys or credentials
+
+## Reporting Issues
+
+Open an issue at [github.com/HarshalJain-cs/AWARTS/issues](https://github.com/HarshalJain-cs/AWARTS/issues) with:
+- Node.js version (`node --version`)
+- OS and version
+- Steps to reproduce
+- Expected vs actual behavior

package/SECURITY.md

@@ -0,0 +1,9 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability, please email **harshaljaincs@gmail.com**.
+
+**Do NOT open a public GitHub issue for security vulnerabilities.**
+
+See the full security policy at [github.com/HarshalJain-cs/AWARTS/SECURITY.md](https://github.com/HarshalJain-cs/AWARTS/blob/main/SECURITY.md).

package/dist/index.js

@@ -6669,7 +6669,7 @@ function hashEntries(entries) {
 }
 
 // src/commands/sync.ts
-async function syncCommand() {
+async function syncCommand(opts = {}) {
   banner();
   const auth = await loadAuth();
   if (!auth) {
@@ -6749,7 +6749,8 @@ async function syncCommand() {
     const res = await post("/api/usage/submit", {
       entries: cleanEntries,
       source: "cli",
-      hash
+      hash,
+      ...opts.note && { note: opts.note }
     });
     if (!res.ok) {
       submitSpin.fail("Sync failed.");
@@ -7007,7 +7008,8 @@ async function pushCommand(opts) {
     const res = await post("/api/usage/submit", {
       entries: cleanEntries,
       source: "cli",
-      hash
+      hash,
+      ...opts.note && { note: opts.note }
     });
     if (!res.ok) {
       spin.fail("Submission failed.");
@@ -7406,7 +7408,7 @@ async function checkForUpdates() {
 
 // src/index.ts
 var program2 = new Command;
-program2.name("awarts").description("Track your AI coding spend across Claude, Codex, Gemini & Antigravity").version("0.2.9").hook("preAction", () => checkForUpdates());
+program2.name("awarts").description("Track your AI coding spend across Claude, Codex, Gemini & Antigravity").version("0.3.1").hook("preAction", () => checkForUpdates());
 program2.command("login").description("Authenticate with your AWARTS account via device auth").option("--force", "Re-authenticate even if already logged in").action(async (opts) => {
   try {
     if (opts.force) {
@@ -7419,7 +7421,7 @@ program2.command("login").description("Authenticate with your AWARTS account via
     process.exit(1);
   }
 });
-program2.command("push").description("Read local usage data and submit to AWARTS").option("-p, --provider <name>", "Only push data from a specific provider (claude, codex, gemini, antigravity)").option("-n, --dry-run", "Show what would be pushed without submitting").action(async (opts) => {
+program2.command("push").description("Read local usage data and submit to AWARTS").option("-p, --provider <name>", "Only push data from a specific provider (claude, codex, gemini, antigravity)").option("-n, --dry-run", "Show what would be pushed without submitting").option("--note <text>", "Attach a note/description to today's post").action(async (opts) => {
   try {
     await pushCommand(opts);
   } catch (err) {
@@ -7427,9 +7429,9 @@ program2.command("push").description("Read local usage data and submit to AWARTS
     process.exit(1);
   }
 });
-program2.command("sync").description("Auto-detect all providers and push usage data").action(async () => {
+program2.command("sync").description("Auto-detect all providers and push usage data").option("--note <text>", "Attach a note/description to today's post").action(async (opts) => {
   try {
-    await syncCommand();
+    await syncCommand(opts);
   } catch (err) {
     error(err instanceof Error ? err.message : String(err));
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "awarts",
-  "version": "0.2.9",
+  "version": "0.3.1",
   "description": "Track your AI coding across Claude, Codex, Gemini & Antigravity",
   "type": "module",
   "license": "MIT",
@@ -34,7 +34,10 @@
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "CONTRIBUTING.md",
+    "CODE_OF_CONDUCT.md",
+    "SECURITY.md"
   ],
   "sideEffects": false,
   "scripts": {