@sudodevstudio/astro-ai 0.1.0

package/dist/visual/patch-transactions.js

@@ -0,0 +1,259 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, readdir, rename, rm, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+const DEFAULT_MAX_RECOVERY_FILES = 20;
+export class PatchTransactionStore {
+    #resolver;
+    #hooks;
+    #historyFile;
+    #undoStack = [];
+    #redoStack = [];
+    #readyPromise;
+    constructor(resolver, hooks = {}) {
+        this.#resolver = resolver;
+        this.#hooks = hooks;
+        this.#historyFile = hooks.historyFile === undefined
+            ? join(resolver.projectRoot, '.astro', 'astro-ai', 'transactions.json')
+            : hooks.historyFile;
+        this.#readyPromise = this.#load();
+    }
+    ready() { return this.#readyPromise; }
+    commit(kind, file, before, after) {
+        return this.commitBatch(kind, [{ file, before, after }]);
+    }
+    async commitBatch(kind, proposed) {
+        await this.ready();
+        const normalized = proposed.filter(({ before, after }) => before !== after).map(({ file, before, after }) => ({
+            file: this.#resolver.toProjectPath(file),
+            ...(before === undefined ? {} : { before }),
+            ...(after === undefined ? {} : { after }),
+        }));
+        if (normalized.length === 0)
+            throw new Error('The operation would not change the source.');
+        const changes = [];
+        const conflicts = [];
+        for (const change of normalized) {
+            const current = await readOptional(this.#resolver.toAbsoluteProjectFile(change.file));
+            const merged = reconcileChange(change.before, change.after, current);
+            if (!merged.ok) {
+                conflicts.push({ file: change.file, reason: merged.reason });
+                continue;
+            }
+            changes.push({ file: change.file, ...(current === undefined ? {} : { before: current }), ...(merged.after === undefined ? {} : { after: merged.after }) });
+        }
+        if (conflicts.length > 0)
+            await this.#writeRecovery(normalized, conflicts);
+        if (changes.length === 0) {
+            throw new Error(`No files were applied because the source changed during the agent run. The generated diff was saved for recovery. Conflicts: ${conflicts.map(({ file }) => file).join(', ')}`);
+        }
+        await this.#applyWithBoundary(changes, 'after', 'before');
+        const transaction = { id: randomUUID(), kind, changes, createdAt: new Date().toISOString() };
+        this.#undoStack.push(transaction);
+        this.#redoStack.length = 0;
+        await this.#persist();
+        return summarize(transaction, conflicts);
+    }
+    async undo() {
+        await this.ready();
+        const skipped = [];
+        while (this.#undoStack.length > 0) {
+            const transaction = this.#undoStack.pop();
+            if (transaction === undefined)
+                break;
+            const { compatible, conflicts } = await this.#compatibleChanges(transaction.changes, 'after');
+            skipped.push(...conflicts);
+            if (compatible.length === 0)
+                continue;
+            await this.#applyWithBoundary(compatible, 'before', 'after');
+            const applied = { ...transaction, changes: compatible };
+            this.#redoStack.push(applied);
+            await this.#persist();
+            return summarize(applied, skipped);
+        }
+        await this.#persist();
+        if (skipped.length > 0)
+            throw new Error('Undo skipped externally modified transactions; no older compatible transaction remains.');
+        throw new Error('There is no visual operation to undo.');
+    }
+    async redo() {
+        await this.ready();
+        const skipped = [];
+        while (this.#redoStack.length > 0) {
+            const transaction = this.#redoStack.pop();
+            if (transaction === undefined)
+                break;
+            const { compatible, conflicts } = await this.#compatibleChanges(transaction.changes, 'before');
+            skipped.push(...conflicts);
+            if (compatible.length === 0)
+                continue;
+            await this.#applyWithBoundary(compatible, 'after', 'before');
+            const applied = { ...transaction, changes: compatible };
+            this.#undoStack.push(applied);
+            await this.#persist();
+            return summarize(applied, skipped);
+        }
+        await this.#persist();
+        if (skipped.length > 0)
+            throw new Error('Redo skipped externally modified transactions; no older compatible transaction remains.');
+        throw new Error('There is no visual operation to redo.');
+    }
+    state() {
+        const undo = this.#undoStack.at(-1);
+        const redo = this.#redoStack.at(-1);
+        return { canUndo: undo !== undefined, canRedo: redo !== undefined, ...(undo === undefined ? {} : { undoLabel: undo.kind }), ...(redo === undefined ? {} : { redoLabel: redo.kind }) };
+    }
+    async #compatibleChanges(changes, expectedKey) {
+        const compatible = [];
+        const conflicts = [];
+        for (const change of changes) {
+            const current = await readOptional(this.#resolver.toAbsoluteProjectFile(change.file));
+            if (current === change[expectedKey])
+                compatible.push(change);
+            else
+                conflicts.push({ file: change.file, reason: 'The file was changed outside this transaction and was left untouched.' });
+        }
+        return { compatible, conflicts };
+    }
+    async #applyWithRollback(changes, targetKey, rollbackKey) {
+        const applied = [];
+        try {
+            for (const change of changes) {
+                await this.#write(change.file, change[targetKey]);
+                applied.push(change);
+            }
+        }
+        catch (error) {
+            for (const change of applied.reverse())
+                await this.#write(change.file, change[rollbackKey]);
+            throw error;
+        }
+    }
+    async #applyWithBoundary(changes, targetKey, rollbackKey) {
+        const absoluteFiles = changes.map(({ file }) => this.#resolver.toAbsoluteProjectFile(file));
+        await this.#hooks.beforeApply?.(absoluteFiles);
+        try {
+            await this.#applyWithRollback(changes, targetKey, rollbackKey);
+        }
+        finally {
+            await this.#hooks.afterApply?.(absoluteFiles);
+        }
+    }
+    async #write(projectFile, content) {
+        const absoluteFile = this.#resolver.toAbsoluteProjectFile(projectFile);
+        if (content === undefined) {
+            await rm(absoluteFile, { force: true });
+            if (isSourceFile(absoluteFile))
+                this.#resolver.removeFile(absoluteFile);
+            return;
+        }
+        await mkdir(dirname(absoluteFile), { recursive: true });
+        await writeFile(absoluteFile, content, 'utf8');
+        // Vite's watcher is the single re-indexing path, avoiding a duplicate parse.
+    }
+    async #load() {
+        if (this.#historyFile === false)
+            return;
+        try {
+            const parsed = JSON.parse(await readFile(this.#historyFile, 'utf8'));
+            if (parsed.version !== 1 || !Array.isArray(parsed.undo) || !Array.isArray(parsed.redo)) {
+                this.#hooks.onHistoryWarning?.(`Ignored invalid visual transaction history at ${this.#historyFile}. Delete the file to reset undo history.`);
+                return;
+            }
+            this.#undoStack.push(...parsed.undo.slice(-50));
+            this.#redoStack.push(...parsed.redo.slice(-50));
+        }
+        catch (error) {
+            if (isNotFound(error))
+                return;
+            const detail = error instanceof Error ? error.message : 'unknown read error';
+            this.#hooks.onHistoryWarning?.(`Could not load visual transaction history at ${this.#historyFile}: ${detail}. Delete the file to reset undo history.`);
+        }
+    }
+    async #persist() {
+        if (this.#historyFile === false)
+            return;
+        await mkdir(dirname(this.#historyFile), { recursive: true });
+        const temporary = `${this.#historyFile}.${process.pid}.tmp`;
+        await writeFile(temporary, JSON.stringify({ version: 1, undo: this.#undoStack.slice(-50), redo: this.#redoStack.slice(-50) }), 'utf8');
+        await rename(temporary, this.#historyFile);
+    }
+    async #writeRecovery(changes, conflicts) {
+        if (this.#historyFile === false)
+            return;
+        const recovery = join(dirname(this.#historyFile), 'recovery', `${Date.now()}-${randomUUID()}.diff`);
+        await mkdir(dirname(recovery), { recursive: true });
+        await writeFile(recovery, renderDiff(changes), 'utf8');
+        await pruneRecoveryDirectory(dirname(recovery), this.#hooks.maxRecoveryFiles ?? DEFAULT_MAX_RECOVERY_FILES);
+        for (const conflict of conflicts)
+            conflict.recoveryFile = recovery;
+    }
+}
+export async function pruneRecoveryDirectory(directory, maximumFiles = DEFAULT_MAX_RECOVERY_FILES) {
+    const entries = await readdir(directory, { withFileTypes: true });
+    const stale = entries
+        .filter((entry) => entry.isFile() && entry.name.endsWith('.diff'))
+        .map(({ name }) => name)
+        .sort((left, right) => right.localeCompare(left))
+        .slice(Math.max(0, maximumFiles));
+    await Promise.all(stale.map((name) => rm(join(directory, name), { force: true })));
+}
+function reconcileChange(before, after, current) {
+    if (current === before)
+        return { ok: true, ...(after === undefined ? {} : { after }) };
+    if (before === undefined || after === undefined || current === undefined)
+        return { ok: false, reason: 'The file was created, removed, or replaced externally.' };
+    const merged = mergeSingleRegion(before, after, current);
+    return merged === undefined ? { ok: false, reason: 'The generated edit overlaps an external edit.' } : { ok: true, after: merged };
+}
+/** Applies a generated single-region edit when the same source region remains unique in current text. */
+export function mergeSingleRegion(base, generated, current) {
+    let prefix = 0;
+    while (prefix < base.length && prefix < generated.length && base[prefix] === generated[prefix])
+        prefix += 1;
+    let suffix = 0;
+    while (suffix < base.length - prefix && suffix < generated.length - prefix && base[base.length - 1 - suffix] === generated[generated.length - 1 - suffix])
+        suffix += 1;
+    const removed = base.slice(prefix, base.length - suffix);
+    const inserted = generated.slice(prefix, generated.length - suffix);
+    if (removed === '') {
+        const left = base.slice(Math.max(0, prefix - 32), prefix);
+        const right = base.slice(prefix, Math.min(base.length, prefix + 32));
+        const anchor = `${left}${right}`;
+        const index = current.indexOf(anchor);
+        if (anchor === '' || index < 0 || current.indexOf(anchor, index + 1) >= 0)
+            return undefined;
+        return `${current.slice(0, index + left.length)}${inserted}${current.slice(index + left.length)}`;
+    }
+    const index = current.indexOf(removed);
+    if (index < 0 || current.indexOf(removed, index + 1) >= 0)
+        return undefined;
+    return `${current.slice(0, index)}${inserted}${current.slice(index + removed.length)}`;
+}
+function isSourceFile(file) { return /\.(?:astro|jsx?|tsx?)$/.test(file); }
+async function readOptional(file) { try {
+    return await readFile(file, 'utf8');
+}
+catch (error) {
+    if (isNotFound(error))
+        return undefined;
+    throw error;
+} }
+function isNotFound(error) { return typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT'; }
+function summarize(transaction, conflicts = []) {
+    const files = transaction.changes.map(({ file }) => file);
+    return { id: transaction.id, kind: transaction.kind, file: files[0] ?? '', files, createdAt: transaction.createdAt, diff: renderDiff(transaction.changes), ...(conflicts.length === 0 ? {} : { conflicts }) };
+}
+export function renderDiff(changes) {
+    return changes.map(({ file, before = '', after = '' }) => {
+        const beforeLines = before.split('\n');
+        const afterLines = after.split('\n');
+        let prefix = 0;
+        while (prefix < beforeLines.length && prefix < afterLines.length && beforeLines[prefix] === afterLines[prefix])
+            prefix += 1;
+        let suffix = 0;
+        while (suffix < beforeLines.length - prefix && suffix < afterLines.length - prefix && beforeLines[beforeLines.length - 1 - suffix] === afterLines[afterLines.length - 1 - suffix])
+            suffix += 1;
+        return [`--- a/${file}`, `+++ b/${file}`, `@@ ${prefix + 1} @@`, ...beforeLines.slice(prefix, beforeLines.length - suffix).map((line) => `-${line}`), ...afterLines.slice(prefix, afterLines.length - suffix).map((line) => `+${line}`)].join('\n');
+    }).join('\n\n');
+}
+//# sourceMappingURL=patch-transactions.js.map

package/dist/visual/patch-transactions.js.map

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

package/dist/vite/build-ai-plugin.d.ts

@@ -0,0 +1,11 @@
+import type { Plugin } from 'vite';
+import type { AstroResolver } from '../resolver/astro-resolver.js';
+export declare const BUILD_AI_VITE_PLUGIN_NAME: "astro-ai:dev";
+/**
+ * Instruments original Astro and React JSX source before framework compiler
+ * transforms. The ordered pre-hook keeps source ranges aligned with the files
+ * that deterministic operations edit.
+ */
+export declare function buildAIVitePlugin(resolver: AstroResolver): Plugin;
+export declare function sourceFileFromId(id: string): string | undefined;
+//# sourceMappingURL=build-ai-plugin.d.ts.map

package/dist/vite/build-ai-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-ai-plugin.d.ts","sourceRoot":"","sources":["../../src/vite/build-ai-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,eAAO,MAAM,yBAAyB,EAAG,cAAuB,CAAC;AAEjE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAqBjE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO/D"}

package/dist/vite/build-ai-plugin.js

@@ -0,0 +1,45 @@
+export const BUILD_AI_VITE_PLUGIN_NAME = 'astro-ai:dev';
+/**
+ * Instruments original Astro and React JSX source before framework compiler
+ * transforms. The ordered pre-hook keeps source ranges aligned with the files
+ * that deterministic operations edit.
+ */
+export function buildAIVitePlugin(resolver) {
+    return {
+        name: BUILD_AI_VITE_PLUGIN_NAME,
+        apply: 'serve',
+        enforce: 'pre',
+        transform: {
+            order: 'pre',
+            handler(source, id) {
+                const file = sourceFileFromId(id);
+                if (file === undefined || !resolver.ownsFile(file)) {
+                    return null;
+                }
+                return resolver.instrumentFile(file, source);
+            },
+        },
+        configureServer(server) {
+            server.watcher.on('unlink', (file) => {
+                if (isSupportedSourceId(file) && resolver.ownsFile(file))
+                    resolver.removeFile(file);
+            });
+        },
+    };
+}
+export function sourceFileFromId(id) {
+    const [file, query = ''] = id.split('?', 2);
+    if (file === undefined || file.split(/[\\/]/).includes('node_modules'))
+        return undefined;
+    if (!/\.(?:astro|jsx?|tsx?)$/.test(file))
+        return undefined;
+    if (file.endsWith('.astro') && query !== '')
+        return undefined;
+    if (query !== '' && /(?:^|&)(?:astro|type|lang)\b/.test(query))
+        return undefined;
+    return file;
+}
+function isSupportedSourceId(id) {
+    return sourceFileFromId(id) !== undefined;
+}
+//# sourceMappingURL=build-ai-plugin.js.map

package/dist/vite/build-ai-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-ai-plugin.js","sourceRoot":"","sources":["../../src/vite/build-ai-plugin.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,yBAAyB,GAAG,cAAuB,CAAC;AAEjE;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAuB;IACvD,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,KAAK;QACd,SAAS,EAAE;YACT,KAAK,EAAE,KAAK;YACZ,OAAO,CAAC,MAAM,EAAE,EAAE;gBAChB,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;gBAClC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnD,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,OAAO,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC/C,CAAC;SACF;QACD,eAAe,CAAC,MAAM;YACpB,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;gBACnC,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACtF,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,MAAM,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,SAAS,CAAC;IACzF,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3D,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC9D,IAAI,KAAK,KAAK,EAAE,IAAI,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACjF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,EAAU;IACrC,OAAO,gBAAgB,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC;AAC5C,CAAC"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@sudodevstudio/astro-ai",
+  "version": "0.1.0",
+  "description": "Development-only Build with AI tooling for Astro projects.",
+  "license": "MIT",
+  "author": "Maninderpreet Singh",
+  "homepage": "https://github.com/SudoDevStudio/astro-ai#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SudoDevStudio/astro-ai.git",
+    "directory": "packages/astro-ai"
+  },
+  "bugs": {
+    "url": "https://github.com/SudoDevStudio/astro-ai/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "astro-integration",
+    "astro-component",
+    "withastro",
+    "astro",
+    "visual-editor",
+    "devtools",
+    "vite",
+    "codex",
+    "claude",
+    "development-tools"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/integration/index.d.ts",
+      "import": "./dist/integration/index.js"
+    },
+    "./protocol": {
+      "types": "./dist/shared/protocol.d.ts",
+      "import": "./dist/shared/protocol.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check": "tsc --noEmit",
+    "format:check": "prettier --check src/agent/cli-agent-fallback.ts",
+    "test": "npm run test:unit",
+    "test:all": "npm run test:unit && npm run test:hmr && npm run test:production",
+    "test:unit": "npm run build && node --test test/*.test.mjs",
+    "test:hmr": "node test/run-live-tests.mjs",
+    "test:production": "node test/verify-production.mjs",
+    "smoke:hmr": "node test/live-hmr-smoke.mjs",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@astrojs/compiler-rs": "^0.4.0",
+    "@babel/parser": "^7.29.8",
+    "magic-string": "^1.0.0"
+  },
+  "peerDependencies": {
+    "astro": ">=7.0.0 <8.0.0",
+    "vite": ">=7.0.0 <9.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.0",
+    "astro": "^7.2.9",
+    "jsdom": "^29.1.1",
+    "prettier": "^3.9.6",
+    "typescript": "^6.0.3",
+    "vite": "^8.2.2"
+  },
+  "sideEffects": false
+}

package/src/agent/agent-fallback.ts

@@ -0,0 +1,95 @@
+import type { SelectionContext } from '../shared/selection-context.js';
+import type {
+  AgentExternalContext,
+  AgentFileAttachment,
+  AgentRequestMode,
+} from '../shared/protocol.js';
+import type {
+  PatchTransactionStore,
+  PatchTransactionSummary,
+} from '../visual/patch-transactions.js';
+
+export type AgentFallbackRequest = {
+  instruction: string;
+  reason: string;
+  /** Chat window this run belongs to. Each session keeps its own turns and workspace. */
+  sessionId?: string;
+  mode?: AgentRequestMode;
+  selections?: SelectionContext[];
+  /** Project-relative files that the provider may modify. Undefined means project-wide. */
+  editableFiles?: string[];
+  externalContext?: AgentExternalContext;
+  files?: AgentFileAttachment[];
+  signal?: AbortSignal;
+  onProgress?(state: AgentProgressState, message: string): void;
+};
+
+export type AgentProgressState =
+  | 'queued'
+  | 'reading'
+  | 'editing'
+  | 'validation'
+  | 'diagnostics'
+  | 'tool';
+
+export type AgentProviderStatus = {
+  provider: string;
+  available: boolean;
+  authenticated: boolean;
+  message: string;
+};
+
+export type AgentFallbackResult = {
+  provider?: string;
+  response: string;
+  transaction?: PatchTransactionSummary;
+};
+
+/**
+ * Boundary for operations rejected by deterministic capability checks.
+ * Implementations must apply all proposed file changes through the provided
+ * transaction store; browser code never receives provider credentials.
+ */
+export abstract class AgentFallback {
+  abstract status(): Promise<AgentProviderStatus>;
+
+  dispose(): void | Promise<void> {}
+
+  /** Releases the conversation and workspace held for one closed chat window. */
+  closeSession(_sessionId: string): void | Promise<void> {}
+
+  /** Releases every idle session outside the set the page still has open. */
+  retainSessions(_sessionIds: readonly string[]): void | Promise<void> {}
+
+  abstract execute(
+    request: AgentFallbackRequest,
+    transactions: PatchTransactionStore,
+  ): Promise<AgentFallbackResult>;
+}
+
+export class UnavailableAgentFallback extends AgentFallback {
+  readonly #message: string;
+
+  constructor(message = 'No CLI agent provider is configured.') {
+    super();
+    this.#message = message;
+  }
+
+  status(): Promise<AgentProviderStatus> {
+    return Promise.resolve({
+      provider: 'none',
+      available: false,
+      authenticated: false,
+      message: this.#message,
+    });
+  }
+
+  execute(
+    _request: AgentFallbackRequest,
+    _transactions: PatchTransactionStore,
+  ): Promise<AgentFallbackResult> {
+    return Promise.reject(
+      new Error(this.#message),
+    );
+  }
+}