@lesliechan721/aw 0.1.0-beta.4 → 0.1.0-beta.40

package/dist/src/commands/catalog-status.d.ts

@@ -0,0 +1,56 @@
+import { type CatalogWorkspaceResolvedFrom } from './catalog-workspace-resolution.js';
+export interface CatalogStatusReceipt {
+    schemaVersion: 2;
+    command: 'catalog:status';
+    ok: boolean;
+    workspaceRoot: string;
+    workspaceRootResolvedFrom: CatalogWorkspaceResolvedFrom | null;
+    workspace: {
+        root: string;
+        resolvedFrom: CatalogWorkspaceResolvedFrom | null;
+        valid: boolean;
+        identity: string | null;
+    };
+    catalog: {
+        valid: boolean;
+        version: string | null;
+        channel: 'latest' | 'beta' | null;
+        ownerName: string | null;
+        ownerUrl: string | null;
+        displayName: string | null;
+    };
+    plugins: Array<{
+        name: string;
+        version: string;
+        dependencies: string[];
+        sourceValid: true;
+    }>;
+    dependencyGraph: {
+        valid: boolean;
+        order: string[];
+    };
+    git: {
+        checked: boolean;
+        sourceHead: string | null;
+        clean: boolean | null;
+    };
+    snapshot: {
+        path: string;
+        state: 'absent' | 'current' | 'stale' | 'invalid';
+        valid: boolean;
+        catalogVersion: string | null;
+        snapshotDigest: string | null;
+        sourceIdentityMatches: boolean | null;
+    };
+    issues: Array<{
+        code: string;
+        message: string;
+        blocking: boolean;
+    }>;
+}
+export declare function getCatalogStatus(options: {
+    cwd: string;
+    workspaceRoot?: string;
+    env: NodeJS.ProcessEnv;
+}): Promise<CatalogStatusReceipt>;
+export declare function renderCatalogStatus(receipt: CatalogStatusReceipt): string;

package/dist/src/commands/catalog-status.js

@@ -0,0 +1,217 @@
+import { execFile } from 'node:child_process';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import fs from 'fs-extra';
+import { calculateCatalogWorkspaceSourceIdentity, DEFAULT_CATALOG_OUTPUT_PATH, deriveCatalogChannel, readCatalogWorkspace, validateCatalogSnapshotComplete, } from '@lesliechan721/aw-plugin-core';
+import { resolveCatalogWorkspaceRoot, } from './catalog-workspace-resolution.js';
+import { CLI_RESERVED_IMPORTS } from '../utils/manifest.js';
+const execFileAsync = promisify(execFile);
+function safeIssueMessage(message, workspaceRoot) {
+    return message.replaceAll(workspaceRoot, '<workspace>');
+}
+function dependencyOrder(workspace) {
+    const byName = new Map(workspace.plugins.map((plugin) => [plugin.manifest.name, plugin]));
+    const visiting = new Set();
+    const visited = new Set();
+    const result = [];
+    const visit = (name) => {
+        if (visiting.has(name))
+            throw new Error(`Plugin dependency cycle includes ${JSON.stringify(name)}.`);
+        if (visited.has(name))
+            return;
+        const plugin = byName.get(name);
+        if (!plugin)
+            throw new Error(`Missing same-source plugin dependency ${JSON.stringify(name)}.`);
+        visiting.add(name);
+        for (const dependency of [...(plugin.manifest.dependencies ?? [])].sort())
+            visit(dependency);
+        visiting.delete(name);
+        visited.add(name);
+        result.push(name);
+    };
+    for (const plugin of [...workspace.plugins].sort((left, right) => left.manifest.name.localeCompare(right.manifest.name))) {
+        visit(plugin.manifest.name);
+    }
+    return result;
+}
+function applyWorkspaceFacts(receipt, workspace, reportedRoot, resolvedFrom = receipt.workspace.resolvedFrom) {
+    receipt.issues = receipt.issues.filter((issue) => issue.code !== 'workspaceInvalid' && issue.code !== 'dependencyGraphInvalid');
+    receipt.workspace = {
+        root: reportedRoot,
+        resolvedFrom,
+        valid: true,
+        identity: workspace.workspaceIdentity,
+    };
+    receipt.workspaceRoot = reportedRoot;
+    receipt.workspaceRootResolvedFrom = resolvedFrom;
+    receipt.catalog = {
+        valid: true,
+        version: workspace.metadata.catalog.version,
+        channel: deriveCatalogChannel(workspace.metadata.catalog.version),
+        ownerName: workspace.metadata.owner.name,
+        ownerUrl: workspace.metadata.owner.url,
+        displayName: workspace.metadata.interface.displayName,
+    };
+    receipt.plugins = workspace.plugins.map((plugin) => ({
+        name: plugin.manifest.name,
+        version: plugin.manifest.version,
+        dependencies: [...(plugin.manifest.dependencies ?? [])].sort(),
+        sourceValid: true,
+    }));
+    receipt.dependencyGraph = { valid: false, order: [] };
+    try {
+        receipt.dependencyGraph = { valid: true, order: dependencyOrder(workspace) };
+    }
+    catch (error) {
+        receipt.issues.push({
+            code: 'dependencyGraphInvalid',
+            message: safeIssueMessage(error instanceof Error ? error.message : String(error), reportedRoot),
+            blocking: true,
+        });
+    }
+}
+async function inspectSnapshot(receipt, workspace) {
+    const snapshotPath = path.join(workspace.workspaceRoot, DEFAULT_CATALOG_OUTPUT_PATH);
+    receipt.snapshot.path = snapshotPath;
+    if (!(await fs.pathExists(snapshotPath)))
+        return;
+    try {
+        const [validation, marker, sourceIdentity] = await Promise.all([
+            validateCatalogSnapshotComplete(snapshotPath),
+            fs.readJson(path.join(snapshotPath, '.aw-generated.json')),
+            calculateCatalogWorkspaceSourceIdentity(workspace),
+        ]);
+        const sourceIdentityMatches = marker.workspaceIdentity === workspace.workspaceIdentity
+            && marker.sourceIdentity === sourceIdentity;
+        receipt.snapshot = {
+            path: snapshotPath,
+            state: sourceIdentityMatches ? 'current' : 'stale',
+            valid: true,
+            catalogVersion: validation.manifest.catalogVersion,
+            snapshotDigest: validation.snapshotDigest,
+            sourceIdentityMatches,
+        };
+    }
+    catch {
+        receipt.snapshot = {
+            path: snapshotPath,
+            state: 'invalid',
+            valid: false,
+            catalogVersion: null,
+            snapshotDigest: null,
+            sourceIdentityMatches: null,
+        };
+    }
+}
+async function inspectGit(workspaceRoot, env) {
+    const gitEnv = Object.fromEntries(Object.entries(env).filter(([key]) => !key.startsWith('GIT_')));
+    gitEnv.GIT_OPTIONAL_LOCKS = '0';
+    try {
+        const repoRoot = (await execFileAsync('git', ['rev-parse', '--show-toplevel'], {
+            cwd: workspaceRoot,
+            env: gitEnv,
+            encoding: 'utf8',
+        })).stdout.trim();
+        const sourceHead = (await execFileAsync('git', ['rev-parse', '--verify', 'HEAD'], {
+            cwd: repoRoot,
+            env: gitEnv,
+            encoding: 'utf8',
+        })).stdout.trim();
+        const status = (await execFileAsync('git', [
+            'status', '--porcelain=v1', '--untracked-files=all', '--ignore-submodules=none',
+        ], {
+            cwd: repoRoot,
+            env: gitEnv,
+            encoding: 'utf8',
+            maxBuffer: 16 * 1024 * 1024,
+        })).stdout.trim();
+        return { checked: true, sourceHead, clean: status === '' };
+    }
+    catch {
+        return { checked: false, sourceHead: null, clean: null };
+    }
+}
+function emptyReceipt(workspaceRoot) {
+    return {
+        schemaVersion: 2,
+        command: 'catalog:status',
+        ok: false,
+        workspaceRoot,
+        workspaceRootResolvedFrom: null,
+        workspace: { root: workspaceRoot, resolvedFrom: null, valid: false, identity: null },
+        catalog: {
+            valid: false,
+            version: null,
+            channel: null,
+            ownerName: null,
+            ownerUrl: null,
+            displayName: null,
+        },
+        plugins: [],
+        dependencyGraph: { valid: false, order: [] },
+        git: { checked: false, sourceHead: null, clean: null },
+        snapshot: {
+            path: path.join(workspaceRoot, DEFAULT_CATALOG_OUTPUT_PATH),
+            state: 'absent',
+            valid: false,
+            catalogVersion: null,
+            snapshotDigest: null,
+            sourceIdentityMatches: null,
+        },
+        issues: [],
+    };
+}
+export async function getCatalogStatus(options) {
+    const requestedRoot = path.resolve(options.cwd, options.workspaceRoot ?? '.');
+    let resolution = null;
+    try {
+        resolution = await resolveCatalogWorkspaceRoot({
+            cwd: options.cwd,
+            ...(options.workspaceRoot === undefined ? {} : { explicitRoot: options.workspaceRoot }),
+            mode: 'existing',
+        });
+    }
+    catch {
+        // Preserve a structured status receipt below.
+    }
+    const workspaceRoot = resolution?.workspaceRoot ?? requestedRoot;
+    const receipt = emptyReceipt(workspaceRoot);
+    receipt.workspace.resolvedFrom = resolution?.workspaceRootResolvedFrom ?? null;
+    receipt.workspaceRootResolvedFrom = resolution?.workspaceRootResolvedFrom ?? null;
+    try {
+        if (!resolution) {
+            await resolveCatalogWorkspaceRoot({
+                cwd: options.cwd,
+                ...(options.workspaceRoot === undefined ? {} : { explicitRoot: options.workspaceRoot }),
+                mode: 'existing',
+            });
+        }
+        const workspace = await readCatalogWorkspace(workspaceRoot, { reservedImports: CLI_RESERVED_IMPORTS });
+        applyWorkspaceFacts(receipt, workspace, workspace.workspaceRoot, resolution?.workspaceRootResolvedFrom ?? null);
+        await inspectSnapshot(receipt, workspace);
+    }
+    catch (error) {
+        receipt.issues.push({
+            code: 'workspaceInvalid',
+            message: safeIssueMessage(error instanceof Error ? error.message : String(error), workspaceRoot),
+            blocking: true,
+        });
+    }
+    receipt.git = await inspectGit(workspaceRoot, options.env);
+    receipt.ok = !receipt.issues.some((issue) => issue.blocking);
+    return receipt;
+}
+export function renderCatalogStatus(receipt) {
+    const lines = [
+        `Catalog Workspace: ${receipt.workspace.valid ? 'valid' : 'invalid'}`,
+        `Catalog: ${receipt.catalog.version ?? 'unavailable'}${receipt.catalog.channel ? ` (${receipt.catalog.channel})` : ''}`,
+        `Plugins: ${receipt.plugins.length}`,
+        `Dependency graph: ${receipt.dependencyGraph.valid ? 'valid' : 'invalid'}`,
+        `Git: ${receipt.git.checked ? `${receipt.git.sourceHead} (${receipt.git.clean ? 'clean' : 'dirty'})` : 'not checked'}`,
+    ];
+    lines.push(`Snapshot: ${receipt.snapshot.state}${receipt.snapshot.snapshotDigest ? ` (${receipt.snapshot.snapshotDigest})` : ''}`);
+    for (const issue of receipt.issues)
+        lines.push(`Issue ${issue.code}: ${issue.message}`);
+    return `${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=catalog-status.js.map

package/dist/src/commands/catalog-status.js.map

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

package/dist/src/commands/catalog-store.d.ts

@@ -0,0 +1,104 @@
+export type CatalogStoreEntryCategory = 'entry' | 'staging' | 'replacement' | 'quarantine' | 'deleteClaim' | 'foreign';
+export type CatalogStoreEntryStatus = 'active' | 'reclaimable' | 'retained' | 'error';
+export type CatalogStoreGenerationReference = 'active' | 'orphan' | 'none';
+export interface CatalogStoreInspectionError {
+    storeKey: string;
+    code: 'catalogStoreInspectionFailed';
+    message: string;
+}
+export interface CatalogStoreInspectionEntry {
+    storeKey: string;
+    category: CatalogStoreEntryCategory;
+    status: CatalogStoreEntryStatus;
+    generationReference: CatalogStoreGenerationReference;
+    ageMs: number | null;
+    reclaimableBytes: number | null;
+    reason: string;
+}
+export interface CatalogStoreStatusResult {
+    catalogStoreSchemaVersion: 2;
+    command: 'catalog:store:status';
+    ok: boolean;
+    entries: CatalogStoreInspectionEntry[];
+    totals: {
+        entries: number;
+        reclaimableEntries: number;
+        reclaimableBytes: number | null;
+    };
+    errors: CatalogStoreInspectionError[];
+}
+export interface CatalogStoreStatusFailureResult {
+    catalogStoreSchemaVersion: 2;
+    command: 'catalog:store:status';
+    ok: false;
+    entries: [];
+    errors: Array<{
+        code: string;
+        message: string;
+    }>;
+}
+export interface CatalogStorePruneResult {
+    catalogStoreSchemaVersion: 2;
+    command: 'catalog:store:prune';
+    ok: boolean;
+    overallState: 'succeeded' | 'partial';
+    dryRun: boolean;
+    entries: CatalogStoreInspectionEntry[];
+    deleted: Array<{
+        storeKey: string;
+        bytes: number;
+    }>;
+    retained: Array<{
+        storeKey: string;
+        reason: string;
+    }>;
+    errors: Array<CatalogStoreInspectionError | {
+        storeKey: string;
+        code: 'catalogStoreDeleteFailed';
+        message: string;
+    }>;
+    reclaimableBytes: number | null;
+    deletedBytes: number;
+}
+export interface CatalogStorePruneFailureResult {
+    catalogStoreSchemaVersion: 2;
+    command: 'catalog:store:prune';
+    ok: false;
+    overallState: 'failed';
+    dryRun: boolean;
+    entries: [];
+    deleted: [];
+    retained: [];
+    errors: Array<{
+        code: string;
+        message: string;
+    }>;
+    reclaimableBytes: null;
+    deletedBytes: 0;
+}
+interface CatalogStorePruneRuntime {
+    afterInitialInspection?(entries: readonly CatalogStoreInspectionEntry[]): Promise<void> | void;
+    updateDeleteClaimTime?(target: string, now: Date): Promise<void> | void;
+    afterDeleteClaim?(options: {
+        storeKey: string;
+        claimPath: string;
+    }): Promise<void> | void;
+}
+export interface CatalogStorePruneItemKey {
+    storeKey: string;
+    category: CatalogStoreEntryCategory;
+}
+export declare function catalogStoreErrorCode(error: unknown): string;
+export declare function catalogStoreStatus(options?: {
+    env?: NodeJS.ProcessEnv;
+    now?: Date;
+}): Promise<CatalogStoreStatusResult>;
+export declare function catalogStorePrune(options?: {
+    dryRun?: boolean;
+    env?: NodeJS.ProcessEnv;
+    now?: Date;
+    authorizedItems?: readonly CatalogStorePruneItemKey[];
+    remove?: (target: string) => Promise<void>;
+    runtime?: CatalogStorePruneRuntime;
+}): Promise<CatalogStorePruneResult>;
+export {};