@planu/cli 0.15.2

package/dist/tools/git/breaking-ops.js

@@ -0,0 +1,181 @@
+import { git, resolveProjectPath, resolveBaseBranch } from './git-helpers.js';
+export async function handleBreakingCheck(projectId, config) {
+    const projectPath = await resolveProjectPath(projectId);
+    const baseBranch = await resolveBaseBranch(projectPath, config?.baseBranch);
+    if (!baseBranch) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: 'No base branch found for comparison' }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Get changed files between current branch and base
+    const changedFiles = await getChangedFiles(projectPath, baseBranch);
+    // Get the full diff for analysis
+    let diffContent = '';
+    try {
+        const contractFiles = changedFiles.filter((f) => isContractFile(f));
+        if (contractFiles.length > 0) {
+            const { stdout } = await git(projectPath, [
+                'diff',
+                `${baseBranch}...HEAD`,
+                '--',
+                ...contractFiles,
+            ]);
+            diffContent = stdout;
+        }
+    }
+    catch {
+        diffContent = '';
+    }
+    const changes = analyzeBreakingChanges(changedFiles, diffContent);
+    // Find internal consumers of broken contracts
+    const changesWithConsumers = await enrichWithConsumers(projectPath, changes);
+    const hasBreakingChanges = changesWithConsumers.some((c) => c.type === 'breaking');
+    const summary = buildSummary(changesWithConsumers, hasBreakingChanges);
+    const result = {
+        action: 'breaking-check',
+        hasBreakingChanges,
+        changes: changesWithConsumers,
+        summary,
+        message: hasBreakingChanges
+            ? `BREAKING: ${changesWithConsumers.filter((c) => c.type === 'breaking').length} breaking change(s) detected`
+            : `No breaking changes detected (${changesWithConsumers.length} change(s) analyzed)`,
+    };
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+}
+async function getChangedFiles(projectPath, baseBranch) {
+    try {
+        const { stdout } = await git(projectPath, ['diff', '--name-only', `${baseBranch}...HEAD`]);
+        return stdout.trim().split('\n').filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+function isContractFile(file) {
+    return (file.endsWith('.ts') ||
+        file.endsWith('.graphql') ||
+        file.endsWith('.yaml') ||
+        file.endsWith('.yml') ||
+        file.endsWith('.json') ||
+        file.includes('schema') ||
+        file.includes('api') ||
+        file.includes('route') ||
+        file.includes('endpoint'));
+}
+function analyzeBreakingChanges(files, diffContent) {
+    const changes = [];
+    for (const file of files) {
+        if (!isContractFile(file)) {
+            continue;
+        }
+        // Detect removed exports/functions (lines starting with -)
+        const removedLines = diffContent
+            .split('\n')
+            .filter((line) => line.startsWith('-') &&
+            !line.startsWith('---') &&
+            (line.includes('export ') ||
+                line.includes('function ') ||
+                line.includes('interface ') ||
+                line.includes('type ') ||
+                line.includes('DELETE') ||
+                line.includes('Router.delete') ||
+                line.includes('app.delete')));
+        for (const removed of removedLines.slice(0, 5)) {
+            const changeType = classifyChange(removed, file);
+            changes.push({
+                type: changeType,
+                description: `Removed: ${removed.slice(1).trim().slice(0, 100)}`,
+                file,
+                migrationPlan: changeType === 'breaking'
+                    ? 'Update all consumers. Consider deprecation period of 2+ releases.'
+                    : undefined,
+            });
+        }
+        // Detect schema changes
+        if (file.includes('schema') || file.includes('.graphql')) {
+            const removedFields = diffContent
+                .split('\n')
+                .filter((line) => line.startsWith('-') && !line.startsWith('---') && /^\s*-\s+\w+/.test(line));
+            for (const field of removedFields.slice(0, 3)) {
+                changes.push({
+                    type: 'breaking',
+                    description: `Removed field: ${field.slice(1).trim()}`,
+                    file,
+                    migrationPlan: 'Requires schema migration. Check for data dependencies.',
+                });
+            }
+        }
+    }
+    return changes;
+}
+function classifyChange(line, _file) {
+    if (line.includes('export ') ||
+        line.includes('DELETE') ||
+        line.includes('Router.delete') ||
+        line.includes('interface ')) {
+        return 'breaking';
+    }
+    if (line.includes('@deprecated') || line.includes('deprecated')) {
+        return 'deprecation';
+    }
+    return 'non-breaking';
+}
+async function enrichWithConsumers(projectPath, changes) {
+    const enriched = [];
+    for (const change of changes) {
+        if (change.type !== 'breaking' || !change.file) {
+            enriched.push(change);
+            continue;
+        }
+        // Search for consumers of the changed file
+        let consumers = [];
+        try {
+            /* v8 ignore start */
+            const fileName = change.file
+                .split('/')
+                .pop()
+                ?.replace(/\.(ts|js)$/, '') ?? '';
+            /* v8 ignore end */
+            if (fileName) {
+                const { stdout } = await git(projectPath, ['grep', '-l', fileName, '--', '*.ts', '*.js']);
+                consumers = stdout
+                    .trim()
+                    .split('\n')
+                    .filter(Boolean)
+                    .filter((f) => f !== change.file)
+                    .slice(0, 5);
+            }
+        }
+        catch {
+            // ignore
+        }
+        enriched.push({ ...change, consumers });
+    }
+    return enriched;
+}
+function buildSummary(changes, hasBreaking) {
+    const breaking = changes.filter((c) => c.type === 'breaking').length;
+    const deprecations = changes.filter((c) => c.type === 'deprecation').length;
+    const nonBreaking = changes.filter((c) => c.type === 'non-breaking').length;
+    if (!hasBreaking && changes.length === 0) {
+        return 'No contract-affecting changes detected.';
+    }
+    const parts = [];
+    if (breaking > 0) {
+        parts.push(`${breaking} breaking change(s) — requires major version bump`);
+    }
+    if (deprecations > 0) {
+        parts.push(`${deprecations} deprecation(s) — min 2 releases before removal`);
+    }
+    if (nonBreaking > 0) {
+        parts.push(`${nonBreaking} non-breaking change(s)`);
+    }
+    return parts.join('; ');
+}
+//# sourceMappingURL=breaking-ops.js.map

package/dist/tools/git/breaking-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breaking-ops.js","sourceRoot":"","sources":["../../../src/tools/git/breaking-ops.ts"],"names":[],"mappings":"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"}

package/dist/tools/git/changelog-ops.d.ts

@@ -0,0 +1,3 @@
+import type { ToolResult } from '../../types/index.js';
+export declare function handleGenerateChangelog(projectId: string, specId: string | undefined, format?: 'technical' | 'user-facing'): Promise<ToolResult>;
+//# sourceMappingURL=changelog-ops.d.ts.map

package/dist/tools/git/changelog-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-ops.d.ts","sourceRoot":"","sources":["../../../src/tools/git/changelog-ops.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAA4C,MAAM,sBAAsB,CAAC;AAKjG,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,GACnC,OAAO,CAAC,UAAU,CAAC,CAgErB"}

package/dist/tools/git/changelog-ops.js

@@ -0,0 +1,128 @@
+import { specStore } from '../../storage/index.js';
+import { ti } from '../../i18n/index.js';
+import { git, resolveProjectPath } from './git-helpers.js';
+export async function handleGenerateChangelog(projectId, specId, format) {
+    const projectPath = await resolveProjectPath(projectId);
+    const specs = await specStore.listSpecs(projectId);
+    const doneSpecs = specs.filter((s) => (specId ? s.id === specId : s.status === 'done'));
+    const typeGroups = {
+        feature: [],
+        bugfix: [],
+        refactor: [],
+        infra: [],
+        docs: [],
+        project: [],
+    };
+    for (const spec of doneSpecs) {
+        const entry = `- **[${spec.id}]** ${spec.title}`;
+        const group = typeGroups[spec.type];
+        if (group) {
+            group.push(entry);
+        }
+    }
+    let recentCommits = [];
+    try {
+        const { stdout } = await git(projectPath, ['log', '--oneline', '--no-decorate', '-20']);
+        recentCommits = stdout.trim().split('\n').filter(Boolean);
+    }
+    catch {
+        // ignore
+    }
+    /* v8 ignore start */
+    const now = new Date().toISOString().split('T')[0] ?? new Date().toISOString();
+    /* v8 ignore end */
+    const changelogContent = format === 'user-facing'
+        ? buildUserFacingChangelog(doneSpecs, now)
+        : buildTechnicalChangelog(typeGroups, recentCommits, now);
+    const changelog = {
+        type: 'changelog',
+        title: format === 'user-facing' ? 'Release Notes' : 'Changelog',
+        path: format === 'user-facing' ? 'RELEASE_NOTES.md' : 'CHANGELOG.md',
+        content: changelogContent,
+        audience: format === 'user-facing' ? 'end-user' : 'developer',
+        sections: [
+            {
+                title: format === 'user-facing' ? 'Release Notes' : 'Changelog',
+                level: 1,
+                content: changelogContent,
+            },
+        ],
+        diagrams: [],
+        relatedSpecs: doneSpecs.map((s) => s.id),
+    };
+    const result = {
+        action: 'generate-changelog',
+        changelog,
+        message: ti('tools.manage_git.success', { action: 'generate-changelog' }),
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+}
+function buildTechnicalChangelog(typeGroups, recentCommits, now) {
+    const typeLabels = {
+        feature: 'Features',
+        bugfix: 'Bug Fixes',
+        refactor: 'Refactoring',
+        infra: 'Infrastructure',
+        docs: 'Documentation',
+        project: 'Project',
+    };
+    const lines = [`# Changelog`, '', `## [Unreleased] - ${now}`, ''];
+    for (const [type, entries] of Object.entries(typeGroups)) {
+        if (entries.length > 0) {
+            /* v8 ignore start */
+            lines.push(`### ${typeLabels[type] ?? type}`);
+            /* v8 ignore end */
+            lines.push('');
+            lines.push(...entries);
+            lines.push('');
+        }
+    }
+    const unlinkedCommits = recentCommits.filter((c) => !/SPEC-\d{3}/.exec(c));
+    if (unlinkedCommits.length > 0) {
+        lines.push('### Other Changes');
+        lines.push('');
+        for (const commit of unlinkedCommits.slice(0, 10)) {
+            lines.push(`- ${commit}`);
+        }
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push('*Generated by Planu SDD*');
+    return lines.join('\n');
+}
+function buildUserFacingChangelog(doneSpecs, now) {
+    const lines = [`# Release Notes`, '', `## What's New — ${now}`, ''];
+    const features = doneSpecs.filter((s) => s.type === 'feature');
+    const bugfixes = doneSpecs.filter((s) => s.type === 'bugfix');
+    const improvements = doneSpecs.filter((s) => s.type === 'refactor' || s.type === 'infra');
+    if (features.length > 0) {
+        lines.push('### New Features');
+        lines.push('');
+        for (const s of features) {
+            lines.push(`- ${s.title}`);
+        }
+        lines.push('');
+    }
+    if (bugfixes.length > 0) {
+        lines.push('### Bug Fixes');
+        lines.push('');
+        for (const s of bugfixes) {
+            lines.push(`- Fixed: ${s.title}`);
+        }
+        lines.push('');
+    }
+    if (improvements.length > 0) {
+        lines.push('### Improvements');
+        lines.push('');
+        for (const s of improvements) {
+            lines.push(`- ${s.title}`);
+        }
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push('*Generated by Planu SDD*');
+    return lines.join('\n');
+}
+//# sourceMappingURL=changelog-ops.js.map

package/dist/tools/git/changelog-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-ops.js","sourceRoot":"","sources":["../../../src/tools/git/changelog-ops.ts"],"names":[],"mappings":"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"}

package/dist/tools/git/commit-ops.d.ts

@@ -0,0 +1,4 @@
+import type { ToolResult } from '../../types/index.js';
+export declare function handleLinkCommits(projectId: string, specId: string | undefined): Promise<ToolResult>;
+export declare function handleStatus(projectId: string, _specId: string | undefined): Promise<ToolResult>;
+//# sourceMappingURL=commit-ops.d.ts.map

package/dist/tools/git/commit-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-ops.d.ts","sourceRoot":"","sources":["../../../src/tools/git/commit-ops.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAKX,MAAM,sBAAsB,CAAC;AAK9B,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,UAAU,CAAC,CAkGrB;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,OAAO,CAAC,UAAU,CAAC,CAkGrB"}

package/dist/tools/git/commit-ops.js

@@ -0,0 +1,189 @@
+import { specStore } from '../../storage/index.js';
+import { ti } from '../../i18n/index.js';
+import { git, resolveProjectPath, resolveBaseBranch } from './git-helpers.js';
+export async function handleLinkCommits(projectId, specId) {
+    const projectPath = await resolveProjectPath(projectId);
+    const searchPattern = specId ?? 'SPEC-';
+    const commits = [];
+    const orphanCommits = [];
+    try {
+        const { stdout } = await git(projectPath, [
+            'log',
+            '--all',
+            `--grep=${searchPattern}`,
+            '--format=%H|%s|%an|%aI',
+            '-100',
+        ]);
+        if (stdout.trim()) {
+            const lines = stdout.trim().split('\n');
+            for (const line of lines) {
+                const [hash, message, author, date] = line.split('|');
+                if (!hash || !message) {
+                    continue;
+                }
+                const specMatch = message.match(/SPEC-\d{3}/g);
+                const linkedSpecId = specMatch ? specMatch[0] : (specId ?? 'unknown');
+                let filesChanged = [];
+                try {
+                    const { stdout: diffOut } = await git(projectPath, [
+                        'diff-tree',
+                        '--no-commit-id',
+                        '--name-only',
+                        '-r',
+                        hash,
+                    ]);
+                    filesChanged = diffOut.trim().split('\n').filter(Boolean);
+                }
+                catch {
+                    // ignore errors on individual commits
+                }
+                /* v8 ignore start */
+                commits.push({
+                    hash: hash.slice(0, 8),
+                    message,
+                    specId: linkedSpecId,
+                    author: author ?? 'unknown',
+                    date: date ?? new Date().toISOString(),
+                    filesChanged,
+                });
+                /* v8 ignore end */
+            }
+        }
+    }
+    catch {
+        // No matching commits
+    }
+    // Detect commits without SPEC reference (orphan commits)
+    try {
+        const { stdout: allOut } = await git(projectPath, [
+            'log',
+            '--all',
+            '--format=%H|%s|%an|%aI',
+            '-50',
+        ]);
+        if (allOut.trim()) {
+            const lines = allOut.trim().split('\n');
+            for (const line of lines) {
+                const [hash, message, author, date] = line.split('|');
+                if (!hash || !message) {
+                    continue;
+                }
+                if (!/SPEC-\d{3}/i.test(message)) {
+                    orphanCommits.push({
+                        hash: hash.slice(0, 8),
+                        message,
+                        author: author ?? 'unknown',
+                        date: date ?? new Date().toISOString(),
+                    });
+                }
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    const result = {
+        action: 'link-commits',
+        linkedCommits: commits,
+        orphanCommits: orphanCommits.slice(0, 10),
+        message: `Found ${commits.length} commit(s) linked to ${specId ?? 'specs'}${orphanCommits.length > 0 ? `. ${orphanCommits.length} commit(s) without spec reference.` : ''}`,
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+}
+export async function handleStatus(projectId, _specId) {
+    const projectPath = await resolveProjectPath(projectId);
+    const { stdout: branchOut } = await git(projectPath, ['rev-parse', '--abbrev-ref', 'HEAD']);
+    const currentBranch = branchOut.trim();
+    const specMatch = /SPEC-\d{3}/.exec(currentBranch);
+    const linkedSpec = specMatch ? specMatch[0] : undefined;
+    let uncommittedChanges = 0;
+    try {
+        const { stdout } = await git(projectPath, ['status', '--porcelain']);
+        uncommittedChanges = stdout.trim().split('\n').filter(Boolean).length;
+    }
+    catch {
+        // ignore
+    }
+    const baseBranch = await resolveBaseBranch(projectPath);
+    let commitsAhead = 0;
+    if (baseBranch && currentBranch !== baseBranch) {
+        try {
+            const { stdout } = await git(projectPath, ['rev-list', '--count', `${baseBranch}..HEAD`]);
+            commitsAhead = parseInt(stdout.trim(), 10) || 0;
+        }
+        catch {
+            // ignore
+        }
+    }
+    const specsCoveredByCommits = [];
+    try {
+        const { stdout } = await git(projectPath, ['log', '-50', '--format=%s']);
+        const messages = stdout.trim().split('\n');
+        const seenSpecs = new Set();
+        for (const msg of messages) {
+            const matches = msg.match(/SPEC-\d{3}/g);
+            if (matches) {
+                for (const m of matches) {
+                    seenSpecs.add(m);
+                }
+            }
+        }
+        specsCoveredByCommits.push(...seenSpecs);
+    }
+    catch {
+        // ignore
+    }
+    const allSpecs = await specStore.listSpecs(projectId);
+    const specsInProgress = allSpecs.filter((s) => s.status === 'implementing').map((s) => s.id);
+    // Count commits behind develop for each active branch
+    const branchesCommitsBehind = {};
+    try {
+        const { stdout: branchListOut } = await git(projectPath, [
+            'branch',
+            '--list',
+            '--format=%(refname:short)',
+        ]);
+        const branches = branchListOut.trim().split('\n').filter(Boolean);
+        if (baseBranch) {
+            for (const b of branches) {
+                if (b === baseBranch) {
+                    continue;
+                }
+                try {
+                    const { stdout: behindOut } = await git(projectPath, [
+                        'rev-list',
+                        '--count',
+                        `HEAD..${baseBranch}`,
+                    ]);
+                    branchesCommitsBehind[b] = parseInt(behindOut.trim(), 10) || 0;
+                }
+                catch {
+                    branchesCommitsBehind[b] = 0;
+                }
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    const status = {
+        currentBranch,
+        linkedSpec,
+        uncommittedChanges,
+        commitsAhead,
+        specsCoveredByCommits,
+        specsInProgress,
+    };
+    const result = {
+        action: 'status',
+        branchName: currentBranch,
+        status,
+        message: ti('tools.manage_git.success', { action: 'status' }),
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+}
+//# sourceMappingURL=commit-ops.js.map

package/dist/tools/git/commit-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-ops.js","sourceRoot":"","sources":["../../../src/tools/git/commit-ops.ts"],"names":[],"mappings":"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"}

package/dist/tools/git/git-helpers.d.ts

@@ -0,0 +1,27 @@
+import { execFile as execFileCb } from 'node:child_process';
+import type { GitConfig, GitFlowType } from '../../types/index.js';
+export declare const execFile: typeof execFileCb.__promisify__;
+/** Default branch prefixes by spec type. */
+export declare const DEFAULT_BRANCH_PREFIXES: Record<string, string>;
+/** Default protected branches. */
+export declare const DEFAULT_PROTECTED_BRANCHES: string[];
+/** Default staleness threshold (commits behind). */
+export declare const DEFAULT_STALENESS_THRESHOLD = 50;
+/** Execute a git command in the project directory. */
+export declare function git(projectPath: string, args: string[]): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+/** Resolve the project path from project knowledge. */
+export declare function resolveProjectPath(projectId: string): Promise<string>;
+/** Generate a slug from a spec title. */
+export declare function slugify(title: string): string;
+/** Get merged git config with defaults. */
+export declare function mergeConfig(config?: GitConfig): GitConfig;
+/** Resolve base branch (develop → main → master → ''). */
+export declare function resolveBaseBranch(projectPath: string, preferred?: string): Promise<string>;
+/** Count commits that current branch is behind a base branch. */
+export declare function countCommitsBehind(projectPath: string, baseBranch: string): Promise<number>;
+/** Detect git flow type by inspecting branches. */
+export declare function detectGitFlowType(projectPath: string): Promise<GitFlowType>;
+//# sourceMappingURL=git-helpers.d.ts.map

package/dist/tools/git/git-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/git/git-helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnE,eAAO,MAAM,QAAQ,iCAAwB,CAAC;AAE9C,4CAA4C;AAC5C,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAO1D,CAAC;AAEF,kCAAkC;AAClC,eAAO,MAAM,0BAA0B,UAA8C,CAAC;AAEtF,oDAAoD;AACpD,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,sDAAsD;AACtD,wBAAsB,GAAG,CACvB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAe7C;AAED,uDAAuD;AACvD,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM3E;AAED,yCAAyC;AACzC,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAWzD;AAED,0DAA0D;AAC1D,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAahG;AAED,iEAAiE;AACjE,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASjG;AAED,mDAAmD;AACnD,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAiBjF"}