usesteady 0.1.0-alpha.1

package/dist/src/shell/cli/friction-admin.js

@@ -0,0 +1,276 @@
+// Copyright 2026 Shortgigs LLC. PROPRIETARY — NOT FOR PUBLIC DISTRIBUTION.
+// This file is gitignored and intentionally absent from the public npm package.
+// It belongs in the shortgigs/usesteady-ops private repo for production use.
+/**
+ * src/shell/cli/friction-admin.ts
+ *
+ * Admin CLI for friction report review and payout management.
+ *
+ * Usage (via `usesteady admin friction <sub>`):
+ *   usesteady admin friction list             List pending friction issues
+ *   usesteady admin friction review           AI-classify + approve/reject interactively
+ *   usesteady admin friction review --dry-run  AI-classify only, no writes
+ *   usesteady admin friction payouts           Show payout ledger
+ *   usesteady admin friction payouts --pending Show only unpaid approved entries
+ */
+import * as readline from "node:readline";
+import { readAuth, readConfig } from "../../friction/config.js";
+import { fetchPendingIssues, postComment, swapLabel, closeIssue } from "../../friction/github-issues.js";
+import { classifyBatch, loadAnthropicKey } from "../../friction/reviewer.js";
+import { recordDecision, pendingPayouts, allDecisions, ledgerStats } from "../../friction/payout-ledger.js";
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const GREEN = "\x1b[32m";
+const RED = "\x1b[31m";
+const YELLOW = "\x1b[33m";
+const CYAN = "\x1b[36m";
+const DIM = "\x1b[2m";
+function col(text, color) {
+    return `${color}${text}${RESET}`;
+}
+function hr(char = "─", width = 60) {
+    return char.repeat(width);
+}
+function pad(s, n) {
+    return s.length >= n ? s.slice(0, n - 1) + "…" : s.padEnd(n);
+}
+function decisionColor(d) {
+    if (d === "approved")
+        return GREEN;
+    if (d === "rejected")
+        return RED;
+    return YELLOW;
+}
+/** Ask the user a single-key question interactively. */
+async function prompt(question, choices) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise(resolve => {
+        const ask = () => {
+            rl.question(`${question} [${choices.join("/")}]: `, (ans) => {
+                const a = ans.trim().toLowerCase();
+                if (choices.includes(a)) {
+                    rl.close();
+                    resolve(a);
+                }
+                else {
+                    ask();
+                }
+            });
+        };
+        ask();
+    });
+}
+function buildVerdictComment(issue, verdict, final) {
+    const header = final === "approved"
+        ? `## Friction Review — ✅ APPROVED`
+        : `## Friction Review — ❌ REJECTED`;
+    const payoutNote = final === "approved"
+        ? `\n**Payout:** We will reach out to @${issue.user.login} to arrange payment within 14 days.`
+        : `\n**Note:** This report does not meet the payout criteria. No payment will be issued.`;
+    return [
+        header,
+        ``,
+        `**Decision:** ${final}`,
+        `**Confidence:** ${verdict.confidence}%`,
+        `**Reason:** ${verdict.reason}`,
+        payoutNote,
+        ``,
+        `---`,
+        `_Reviewed by UseSteady Friction Reviewer — ${new Date().toISOString()}_`,
+    ].join("\n");
+}
+// ─── Sub-commands ─────────────────────────────────────────────────────────────
+async function cmdList(repo, token) {
+    process.stdout.write(`\n${BOLD}  Pending friction reports — ${repo}${RESET}\n`);
+    process.stdout.write(`  ${hr()}\n\n`);
+    const issues = await fetchPendingIssues(repo, token);
+    if (issues.length === 0) {
+        process.stdout.write(`  ${DIM}No pending issues.${RESET}\n\n`);
+        return;
+    }
+    process.stdout.write(`  ${BOLD}${pad("#", 5)}${pad("Kind", 18)}${pad("Task / Notes", 38)}${pad("Reporter", 18)}${RESET}\n`);
+    process.stdout.write(`  ${hr()}\n`);
+    for (const issue of issues) {
+        const kindMatch = issue.body.match(/\*\*Type:\*\*\s*(.+)/);
+        const kind = kindMatch?.[1]?.trim() ?? "?";
+        const taskMatch = issue.body.match(/  - (.+)/);
+        const notesMatch = issue.body.match(/\*\*Type:\*\*.*\n.*\n.*\n.*\n.*\n\n.*\n([\s\S]*?)\n###/);
+        const task = taskMatch?.[1]?.trim() ?? notesMatch?.[1]?.trim() ?? issue.title;
+        process.stdout.write(`  ${pad(String(issue.number), 5)}${pad(kind, 18)}${col(pad(task, 38), CYAN)}${DIM}@${issue.user.login}${RESET}\n`);
+    }
+    process.stdout.write(`\n  ${DIM}Total: ${issues.length} pending${RESET}\n\n`);
+}
+async function cmdReview(repo, token, dryRun, autoMode) {
+    process.stdout.write(`\n${BOLD}  Friction Review${dryRun ? " (dry-run)" : ""}${RESET}\n`);
+    process.stdout.write(`  ${hr()}\n\n`);
+    const issues = await fetchPendingIssues(repo, token);
+    if (issues.length === 0) {
+        process.stdout.write(`  ${DIM}Nothing to review.${RESET}\n\n`);
+        return;
+    }
+    const classifierMode = loadAnthropicKey() ? "Claude AI (claude-haiku-4-5)" : "rule-based heuristics (set ANTHROPIC_API_KEY for AI)";
+    process.stdout.write(`  Fetched ${issues.length} pending issues. Running classifier [${classifierMode}]...\n\n`);
+    const results = await classifyBatch(issues);
+    // Print the AI summary table
+    process.stdout.write(`  ${BOLD}${pad("#", 5)}${pad("AI Verdict", 12)}${pad("Conf", 6)}${pad("Task input", 32)}${pad("Reason", 44)}${RESET}\n`);
+    process.stdout.write(`  ${hr(undefined, 100)}\n`);
+    for (const { issue, verdict } of results) {
+        const taskMatch = issue.body.match(/  - (.+)/);
+        const notesMatch = issue.body.match(/Reporter notes: (.+)/);
+        const task = taskMatch?.[1]?.trim() ?? notesMatch?.[1]?.trim() ?? "—";
+        process.stdout.write(`  ${pad(String(issue.number), 5)}` +
+            `${col(pad(verdict.decision.toUpperCase(), 12), decisionColor(verdict.decision))}` +
+            `${pad(verdict.confidence + "%", 6)}` +
+            `${col(pad(task, 32), CYAN)}` +
+            `${DIM}${pad(verdict.reason, 44)}${RESET}\n`);
+    }
+    process.stdout.write(`\n`);
+    if (dryRun) {
+        process.stdout.write(`  ${DIM}Dry-run — no changes written.${RESET}\n\n`);
+        return;
+    }
+    let approved = 0;
+    let rejected = 0;
+    let skipped = 0;
+    if (autoMode) {
+        process.stdout.write(`  ${BOLD}Auto mode — committing AI verdicts (skip = no action):${RESET}\n\n`);
+    }
+    else {
+        process.stdout.write(`  ${BOLD}Review each issue:${RESET}\n`);
+        process.stdout.write(`  ${DIM}a = approve  r = reject  s = skip  q = quit${RESET}\n\n`);
+    }
+    for (const { issue, verdict } of results) {
+        const taskMatch = issue.body.match(/  - (.+)/);
+        const task = taskMatch?.[1]?.trim() ?? issue.title;
+        process.stdout.write(`\n  ${BOLD}#${issue.number}${RESET} ${col(task, CYAN)}\n`);
+        process.stdout.write(`  AI: ${col(verdict.decision.toUpperCase(), decisionColor(verdict.decision))} (${verdict.confidence}%)  — ${DIM}${verdict.reason}${RESET}\n`);
+        process.stdout.write(`  ${DIM}${issue.html_url}${RESET}\n`);
+        let finalDecision;
+        if (autoMode) {
+            // In auto mode, commit the AI verdict directly (skip = no action)
+            finalDecision = verdict.decision;
+        }
+        else {
+            const ans = await prompt(`  Decision`, ["a", "r", "s", "q"]).catch(() => "q");
+            if (ans === "q") {
+                process.stdout.write(`\n  ${YELLOW}Aborted.${RESET}\n\n`);
+                break;
+            }
+            finalDecision = ans === "a" ? "approved" : ans === "r" ? "rejected" : "skip";
+        }
+        if (finalDecision === "skip") {
+            skipped++;
+            process.stdout.write(`  ${DIM}Skipped.${RESET}\n`);
+            continue;
+        }
+        const committedDecision = finalDecision;
+        const verdictComment = buildVerdictComment(issue, verdict, committedDecision);
+        process.stdout.write(`  Writing to GitHub...`);
+        try {
+            // Post comment
+            await postComment(repo, issue.number, verdictComment, token);
+            // Swap label
+            await swapLabel(repo, issue.number, "status/pending", `status/${committedDecision}`, token);
+            // Close if rejected
+            if (committedDecision === "rejected") {
+                await closeIssue(repo, issue.number, token);
+            }
+            // Write to payout ledger
+            recordDecision({
+                githubLogin: issue.user.login,
+                issueNumber: issue.number,
+                issueUrl: issue.html_url,
+                verdict: committedDecision,
+                verdictReason: verdict.reason,
+                confidence: verdict.confidence,
+            });
+            if (committedDecision === "approved")
+                approved++;
+            else
+                rejected++;
+            process.stdout.write(` ${col("done", GREEN)}\n`);
+        }
+        catch (err) {
+            process.stdout.write(` ${col("ERROR: " + String(err), RED)}\n`);
+        }
+        // Small pause between GitHub writes
+        await new Promise(r => setTimeout(r, 300));
+    }
+    process.stdout.write(`\n  ${hr()}\n`);
+    process.stdout.write(`  ${GREEN}Approved: ${approved}${RESET}  ` +
+        `${RED}Rejected: ${rejected}${RESET}  ` +
+        `${DIM}Skipped: ${skipped}${RESET}\n\n`);
+    if (approved > 0) {
+        process.stdout.write(`  ${BOLD}Approved reporters are now in the payout ledger.${RESET}\n`);
+        process.stdout.write(`  Run ${CYAN}usesteady admin friction payouts${RESET} to review.\n\n`);
+    }
+}
+async function cmdPayouts(pendingOnly) {
+    process.stdout.write(`\n${BOLD}  Payout Ledger${RESET}\n`);
+    process.stdout.write(`  ${hr()}\n\n`);
+    const stats = ledgerStats();
+    const records = pendingOnly ? pendingPayouts() : allDecisions();
+    process.stdout.write(`  ${GREEN}Approved: ${stats.approved}${RESET}  ` +
+        `${RED}Rejected: ${stats.rejected}${RESET}  ` +
+        `${YELLOW}Pending payout: ${stats.pendingPayout}${RESET}  ` +
+        `${DIM}Paid: ${stats.paid}${RESET}\n\n`);
+    if (records.length === 0) {
+        process.stdout.write(`  ${DIM}No ${pendingOnly ? "pending payout" : ""} records.${RESET}\n\n`);
+        return;
+    }
+    process.stdout.write(`  ${BOLD}${pad("Issue", 8)}${pad("Reporter", 22)}${pad("Verdict", 12)}${pad("Decided", 24)}${pad("Paid", 12)}${RESET}\n`);
+    process.stdout.write(`  ${hr(undefined, 78)}\n`);
+    for (const r of records) {
+        const vColor = r.verdict === "approved" ? GREEN : RED;
+        const paid = r.paidAt ? col("YES", GREEN) : col("pending", DIM);
+        process.stdout.write(`  ${pad("#" + String(r.issueNumber), 8)}` +
+            `${col(pad("@" + r.githubLogin, 22), CYAN)}` +
+            `${col(pad(r.verdict.toUpperCase(), 12), vColor)}` +
+            `${DIM}${pad(r.decidedAt.slice(0, 19).replace("T", " "), 24)}${RESET}` +
+            `${paid}\n`);
+    }
+    process.stdout.write(`\n`);
+}
+// ─── Entry point ──────────────────────────────────────────────────────────────
+export async function runAdmin(args) {
+    const [, sub, ...flags] = args; // args[0] = "friction"
+    const dryRun = flags.includes("--dry-run");
+    const autoMode = flags.includes("--auto");
+    const pendingOnly = flags.includes("--pending");
+    const auth = readAuth();
+    const config = readConfig();
+    if (!auth?.githubToken) {
+        process.stderr.write("\n  usesteady admin: no GitHub token found.\n" +
+            "  Run `usesteady report --auth` first to authenticate.\n\n");
+        process.exit(1);
+    }
+    const repo = config.frictionRepo;
+    const token = auth.githubToken;
+    switch (sub) {
+        case "list":
+            await cmdList(repo, token);
+            break;
+        case "review":
+            await cmdReview(repo, token, dryRun, autoMode);
+            break;
+        case "payouts":
+            await cmdPayouts(pendingOnly);
+            break;
+        default:
+            process.stdout.write([
+                "",
+                "  usesteady admin friction <sub>",
+                "",
+                "  Subcommands:",
+                "    list                   List all status/pending friction issues",
+                "    review                 AI-classify + interactively approve/reject",
+                "    review --dry-run       AI-classify only, no writes to GitHub",
+                "    review --auto          AI-classify and auto-commit all verdicts",
+                "    payouts                Show full payout ledger",
+                "    payouts --pending      Show only unpaid approved entries",
+                "",
+            ].join("\n"));
+    }
+}
+//# sourceMappingURL=friction-admin.js.map

package/dist/src/shell/cli/friction-admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction-admin.js","sourceRoot":"","sources":["../../../../src/shell/cli/friction-admin.ts"],"names":[],"mappings":"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"}

package/dist/src/shell/cli/friction-report.d.ts

@@ -0,0 +1,16 @@
+/**
+ * src/shell/cli/friction-report.ts
+ *
+ * `usesteady report` — interactive friction report CLI.
+ *
+ * Usage:
+ *   usesteady report                   # guided interactive prompt
+ *   usesteady report --auth            # re-authenticate with GitHub
+ *   usesteady report --status          # show queue stats
+ *
+ * This is a public module (open source). No private collection URLs
+ * or admin credentials appear here — everything private lives in
+ * the private ops repo.
+ */
+export declare function runReport(args: string[]): Promise<void>;
+//# sourceMappingURL=friction-report.d.ts.map

package/dist/src/shell/cli/friction-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction-report.d.ts","sourceRoot":"","sources":["../../../../src/shell/cli/friction-report.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AAoFH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuF7D"}

package/dist/src/shell/cli/friction-report.js

@@ -0,0 +1,156 @@
+// Copyright 2026 Shortgigs LLC. Licensed under the Apache License, Version 2.0.
+/**
+ * src/shell/cli/friction-report.ts
+ *
+ * `usesteady report` — interactive friction report CLI.
+ *
+ * Usage:
+ *   usesteady report                   # guided interactive prompt
+ *   usesteady report --auth            # re-authenticate with GitHub
+ *   usesteady report --status          # show queue stats
+ *
+ * This is a public module (open source). No private collection URLs
+ * or admin credentials appear here — everything private lives in
+ * the private ops repo.
+ */
+import * as readline from "node:readline";
+import { readAuth, readConfig } from "../../friction/config.js";
+import { runDeviceFlow } from "../../friction/github-auth.js";
+import { captureManualReport } from "../../friction/auto-capture.js";
+import { flushQueue } from "../../friction/client.js";
+import { queueStats } from "../../friction/queue.js";
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function print(msg) {
+    process.stdout.write(msg + "\n");
+}
+function ask(rl, question) {
+    return new Promise((resolve) => rl.question(question, resolve));
+}
+function clearLine() {
+    process.stdout.write("\r\x1B[K");
+}
+// ─── Auth ─────────────────────────────────────────────────────────────────────
+async function ensureAuth() {
+    const existing = readAuth();
+    if (existing?.githubToken && existing?.githubLogin) {
+        return existing.githubLogin;
+    }
+    print("");
+    print("  To submit a friction report, connect your GitHub account.");
+    print("  This lets Shortgigs LLC identify you for payout and notify you of decisions.");
+    print("");
+    let waitDots = 0;
+    const token = await runDeviceFlow({
+        onCode: ({ userCode, verificationUri }) => {
+            print(`  1. Open: ${verificationUri}`);
+            print(`  2. Enter code: ${userCode}`);
+            print("");
+            print("  Waiting for authorization...");
+        },
+        onWaiting: () => {
+            clearLine();
+            waitDots = (waitDots + 1) % 4;
+            process.stdout.write(`  Waiting${"...".slice(0, waitDots + 1)}  `);
+        },
+    });
+    clearLine();
+    print(`\n  Authenticated as @${token.githubLogin}`);
+    if (token.githubEmail)
+        print(`  Email: ${token.githubEmail}`);
+    print("");
+    return token.githubLogin;
+}
+async function selectKind(rl) {
+    print("  What kind of friction are you reporting?");
+    print("");
+    print("    1. Something in the UI confused or blocked me");
+    print("    2. Install or startup problem (npm install, usesteady ui)");
+    print("    3. Something else");
+    print("");
+    const answer = (await ask(rl, "  Choice [1-3]: ")).trim();
+    switch (answer) {
+        case "1": return "ux-block";
+        case "2": return "install-error";
+        default: return "manual-cli";
+    }
+}
+// ─── Main report flow ─────────────────────────────────────────────────────────
+export async function runReport(args) {
+    const isAuth = args.includes("--auth");
+    const isStatus = args.includes("--status");
+    // ── Status mode ──
+    if (isStatus) {
+        const stats = queueStats();
+        print("");
+        print("  Friction queue status:");
+        print(`    Pending:   ${stats.pending}`);
+        print(`    Submitted: ${stats.submitted}`);
+        print(`    Failed:    ${stats.failed}`);
+        print("");
+        return;
+    }
+    // ── Re-auth mode ──
+    if (isAuth) {
+        await ensureAuth();
+        return;
+    }
+    print("");
+    print("  UseSteady — Friction Report");
+    print("  ─────────────────────────────────────────");
+    print("");
+    print("  Friction reports help improve UseSteady.");
+    print("  Verified reports earn a payout from Shortgigs LLC.");
+    print("");
+    // ── Ensure GitHub auth ──
+    let githubLogin;
+    try {
+        githubLogin = await ensureAuth();
+    }
+    catch (err) {
+        process.stderr.write(`\n  Auth failed: ${String(err)}\n\n`);
+        process.exit(1);
+    }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        // ── Kind selection ──
+        const kind = await selectKind(rl);
+        // ── Description ──
+        print("");
+        print("  Describe the friction in 1-3 sentences.");
+        print("  What did you expect? What happened instead?");
+        print("");
+        const notes = (await ask(rl, "  > ")).trim();
+        if (!notes) {
+            print("\n  No description entered. Cancelled.\n");
+            rl.close();
+            return;
+        }
+        rl.close();
+        // ── Enqueue ──
+        const id = captureManualReport({ kind, notes, context: {} });
+        print("");
+        print("  Report queued locally.");
+        print(`  ID: ${id}`);
+        print("");
+        print("  Submitting to Shortgigs LLC...");
+        const config = readConfig();
+        const n = await flushQueue(config);
+        if (n > 0) {
+            print(`  Submitted. @${githubLogin} will be notified of the decision via GitHub.`);
+        }
+        else {
+            print("  Could not submit right now — saved locally and will retry automatically.");
+            print("  Run `usesteady report --status` to check queue.");
+        }
+        print("");
+    }
+    catch (err) {
+        rl.close();
+        process.stderr.write(`\n  Report failed: ${String(err)}\n\n`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=friction-report.js.map

package/dist/src/shell/cli/friction-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction-report.js","sourceRoot":"","sources":["../../../../src/shell/cli/friction-report.ts"],"names":[],"mappings":"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"}

package/dist/src/shell/cli/main.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Phase 9A + 9E + 10C: Product Shell — CLI main loop.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   A thin readline loop that drives CursorProductSession, ClaudeProductSession,
+ *   or a WorkflowRun end-to-end from the terminal.
+ *
+ *   This is the only file in the shell layer with I/O. Everything else is pure.
+ *
+ * ── Usage ─────────────────────────────────────────────────────────────────────
+ *
+   *   npx tsx src/shell/cli/main.ts cursor [workspace-root]
+ *   npx tsx src/shell/cli/main.ts claude
+ *   npx tsx src/shell/cli/main.ts workflow [spec.json] [workspace-root]
+ *   npx tsx src/shell/cli/main.ts history [store-dir]
+ *
+ *   workflow spec.json format:
+ *     {
+ *       "name": "My workflow",
+ *       "tasks": [
+ *         { "input": "replace X with Y in src/Button.tsx", "label": "Optional label" },
+ *         { "input": "...", "runtime": "claude" }
+ *       ],
+ *       "defaultRuntime": "cursor",
+ *       "maxRetries": 2
+ *     }
+ *   If no spec.json is provided, the CLI prompts H to build a spec interactively.
+ *
+ *   Environment variables (Claude runtime):
+ *     ANTHROPIC_API_KEY  — required for real Claude calls
+ *     USESTEADY_USE_CLAUDE=true — opt-in to live API; stub otherwise
+ *
+ * ── Loop contract ─────────────────────────────────────────────────────────────
+ *
+ *   Single-session (cursor / claude):
+ *     1. submit() — run intake + prepare
+ *     2. render()  — print phase header + display + prompt (if any)
+ *     3. read answer — y/n for confirm, number for choose
+ *     4. advance() — call appropriate session function(s)
+ *     5. render() again — print result
+ *     6. start new session
+ *
+ *   Workflow (Phase 9E + 11D, WS6 generic loop):
+ *     1. createWorkflowRun() → "reviewing" — H reviews the full task list first
+ *     2. renderWorkflowFrame() — print phase header + task detail + prompt
+ *     3. dispatch on frame.prompt?.kind — confirm or choose, no runtime branching
+ *     4. advanceWorkflowOnConfirm (reviewing → startWorkflow / cancelWorkflow)
+ *        advanceWorkflowOnConfirm / advanceWorkflowOnChoice (task execution)
+ *     5. loop until isWorkflowTerminal()
+ *
+ *   "exit" at the input prompt quits the loop.
+ *
+ * ── What this loop does NOT do ────────────────────────────────────────────────
+ *
+ *   NOT evaluate policy  — policy comes from defaults.ts / DEFAULT_WORKFLOW_POLICIES
+ *   NOT decide approval  — reads from user, passes to session / coordinator
+ *   NOT manage sessions  — each command = new session; each workflow run = new run
+ */
+import type { WorkflowSpec } from "../../workflow/types.js";
+/**
+ * Load a WorkflowSpec from a JSON file.
+ *
+ * Validates required fields; throws with a clear message on malformed input.
+ * Exported for unit testing (pure function — no readline).
+ */
+export declare function loadWorkflowSpecFromFile(filePath: string): WorkflowSpec;
+//# sourceMappingURL=main.d.ts.map

package/dist/src/shell/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../src/shell/cli/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AA8CH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAiL5D;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CA+DvE"}