uicontract 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 UIC Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,60 @@
+# uic
+
+CLI tool that makes web app UIs machine-readable for AI agents.
+
+## Install
+
+```bash
+npm install -g uic
+# or use without installing:
+npx uic <command>
+```
+
+## Usage
+
+```bash
+# Scan a project and produce a manifest
+npx uic scan ./my-app
+
+# Find elements by label or ID pattern
+npx uic find "login"
+
+# Describe a specific element
+npx uic describe settings.billing.pause-subscription.button
+
+# List all elements in the manifest
+npx uic list
+
+# Insert data-agent-id attributes into source files (dry run first)
+npx uic annotate --dry-run
+npx uic annotate
+
+# Diff the current manifest against a baseline (CI gate)
+npx uic diff
+
+# All commands support --help and --json
+npx uic scan --help
+npx uic list --json
+```
+
+## Commands
+
+| Command    | Description                                                    |
+|------------|----------------------------------------------------------------|
+| `scan`     | Parse source files and generate `manifest.json`               |
+| `name`     | Assign hierarchical agent IDs to discovered elements          |
+| `annotate` | Insert `data-agent-id` attributes into source files           |
+| `find`     | Search elements by label, ID pattern, or type                 |
+| `describe` | Show full details for a single element by agent ID            |
+| `list`     | List all elements in the manifest                             |
+| `diff`     | Compare two manifests and report breaking changes             |
+
+Every command accepts `--help` for flag documentation and `--json` for machine-readable output.
+
+## Part of UIC
+
+This package is part of [UIC (UI Contracts)](https://github.com/sherifkozman/uicontract) — making web app UIs machine-readable.
+
+## License
+
+[MIT](../../LICENSE)

package/dist/bin/uic.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * uic CLI entry point.
+ *
+ * stdout: command output (manifests, query results)
+ * stderr: logs, errors, help
+ */
+export {};
+//# sourceMappingURL=uic.d.ts.map

package/dist/bin/uic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uic.d.ts","sourceRoot":"","sources":["../../src/bin/uic.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/bin/uic.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+/**
+ * uic CLI entry point.
+ *
+ * stdout: command output (manifests, query results)
+ * stderr: logs, errors, help
+ */
+import { VERSION } from '@uicontract/core';
+import { scanCommand, findCommand, describeCommand, listCommand, diffCommand, nameCommand, annotateCommand, } from '../commands/index.js';
+const MAIN_HELP = `\
+uic — makes web app UIs machine-readable
+
+USAGE
+  uic <command> [options]
+
+COMMANDS
+  scan <directory>    Scan a project and emit a UI manifest
+  name <manifest>     Assign stable agent IDs to elements in a manifest
+  annotate            Insert data-agent-id attributes into source files
+  find <query>        Search for elements by name, label, route, or handler
+  describe <id>       Show full details of an element by agent ID
+  list                List all elements with optional filtering
+  diff <old> <new>    Compare two manifests and report changes
+
+GLOBAL OPTIONS
+  --version, -V       Print the uic version and exit
+  --help, -h          Show this help message
+
+Run "uicontract <command> --help" for command-specific help.
+  e.g. uic scan --help
+`;
+async function main() {
+    const args = process.argv.slice(2);
+    const [command, ...rest] = args;
+    // Global --version / -V
+    if (command === '--version' || command === '-V') {
+        process.stdout.write(`uic v${VERSION}\n`);
+        process.exit(0);
+    }
+    // Global --help / -h (or no args)
+    if (command === '--help' || command === '-h' || command === undefined) {
+        process.stderr.write(MAIN_HELP);
+        process.exit(0);
+    }
+    // Route to subcommands
+    if (command === 'scan') {
+        const code = await scanCommand(rest);
+        process.exit(code);
+    }
+    if (command === 'find') {
+        const code = await findCommand(rest);
+        process.exit(code);
+    }
+    if (command === 'describe') {
+        const code = await describeCommand(rest);
+        process.exit(code);
+    }
+    if (command === 'list') {
+        const code = await listCommand(rest);
+        process.exit(code);
+    }
+    if (command === 'diff') {
+        const code = await diffCommand(rest);
+        process.exit(code);
+    }
+    if (command === 'name') {
+        const code = await nameCommand(rest);
+        process.exit(code);
+    }
+    if (command === 'annotate') {
+        const code = await annotateCommand(rest);
+        process.exit(code);
+    }
+    // Unknown command
+    process.stderr.write(`Error: Unknown command "${command}". Run "uicontract --help" for the list of commands.\n`);
+    // Provide a hint if the user forgot to specify a subcommand and passed a path
+    if (command.startsWith('.') || command.startsWith('/')) {
+        process.stderr.write(`Hint: Did you mean "uicontract scan ${command}"?\n`);
+    }
+    process.exit(1);
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`Fatal: ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=uic.js.map

package/dist/bin/uic.js.map

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

package/dist/commands/annotate.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `uic annotate` command — insert data-agent-id attributes into source files.
+ *
+ * stdout: unified diff patches (or JSON)
+ * stderr: logs, errors, help text
+ */
+export declare const ANNOTATE_HELP = "uic annotate [options]\n\nInsert data-agent-id attributes into source files based on a manifest.\n\nOPTIONS\n  --manifest <path>      Path to manifest file (default: manifest.json)\n  --dry-run              Show patches without modifying files (default)\n  --write                Modify source files in-place (creates backup first)\n  --backup-dir <dir>     Backup directory (default: .uic-backup)\n  --json                 Output results as JSON\n  --help, -h             Show this help message\n\nEXAMPLES\n  uic annotate\n  uic annotate --manifest named-manifest.json --dry-run\n  uic annotate --write\n  uic annotate --write --backup-dir ./my-backup\n  uic annotate --json\n\nRun \"uicontract --help\" for the full list of commands.\n";
+export interface AnnotateArgs {
+    manifest: string;
+    dryRun: boolean;
+    write: boolean;
+    backupDir: string;
+    json: boolean;
+    help: boolean;
+}
+export interface AnnotateArgsError {
+    error: string;
+}
+export declare function parseAnnotateArgs(args: string[]): AnnotateArgs | AnnotateArgsError;
+export declare function annotateCommand(args: string[]): Promise<number>;
+//# sourceMappingURL=annotate.d.ts.map

package/dist/commands/annotate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotate.d.ts","sourceRoot":"","sources":["../../src/commands/annotate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,eAAO,MAAM,aAAa,uuBAqBzB,CAAC;AAMF,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,GAAG,iBAAiB,CA2DlF;AAkCD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsIrE"}

package/dist/commands/annotate.js

@@ -0,0 +1,236 @@
+/**
+ * `uic annotate` command — insert data-agent-id attributes into source files.
+ *
+ * stdout: unified diff patches (or JSON)
+ * stderr: logs, errors, help text
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { deserializeManifest } from '@uicontract/core';
+import { annotateSource, generatePatch, createBackup, cleanupBackup, } from '@uicontract/annotator';
+// ---------------------------------------------------------------------------
+// Help text
+// ---------------------------------------------------------------------------
+export const ANNOTATE_HELP = `\
+uic annotate [options]
+
+Insert data-agent-id attributes into source files based on a manifest.
+
+OPTIONS
+  --manifest <path>      Path to manifest file (default: manifest.json)
+  --dry-run              Show patches without modifying files (default)
+  --write                Modify source files in-place (creates backup first)
+  --backup-dir <dir>     Backup directory (default: .uic-backup)
+  --json                 Output results as JSON
+  --help, -h             Show this help message
+
+EXAMPLES
+  uic annotate
+  uic annotate --manifest named-manifest.json --dry-run
+  uic annotate --write
+  uic annotate --write --backup-dir ./my-backup
+  uic annotate --json
+
+Run "uicontract --help" for the full list of commands.
+`;
+export function parseAnnotateArgs(args) {
+    let manifest = 'manifest.json';
+    let dryRun = false;
+    let write = false;
+    let backupDir = '.uic-backup';
+    let json = false;
+    let help = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            help = true;
+            continue;
+        }
+        if (arg === '--json') {
+            json = true;
+            continue;
+        }
+        if (arg === '--dry-run') {
+            dryRun = true;
+            continue;
+        }
+        if (arg === '--write') {
+            write = true;
+            continue;
+        }
+        if (arg === '--manifest') {
+            const next = args[i + 1];
+            if (next === undefined || next.startsWith('-')) {
+                return { error: 'Missing value for --manifest. Example: --manifest manifest.json' };
+            }
+            manifest = next;
+            i++;
+            continue;
+        }
+        if (arg === '--backup-dir') {
+            const next = args[i + 1];
+            if (next === undefined || next.startsWith('-')) {
+                return { error: 'Missing value for --backup-dir. Example: --backup-dir .uic-backup' };
+            }
+            backupDir = next;
+            i++;
+            continue;
+        }
+        if (arg !== undefined && arg.startsWith('-')) {
+            return { error: `Unknown option: ${arg}. Run "uicontract annotate --help" for usage.` };
+        }
+        if (arg !== undefined) {
+            return { error: `Unexpected argument: "${arg}". "uicontract annotate" takes no positional arguments.` };
+        }
+    }
+    // Default to dry-run if --write not specified
+    if (!write) {
+        dryRun = true;
+    }
+    return { manifest, dryRun, write, backupDir, json, help };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Group elements by their file path. */
+function groupByFile(elements) {
+    const groups = new Map();
+    for (const el of elements) {
+        const existing = groups.get(el.filePath);
+        if (existing !== undefined) {
+            existing.push(el);
+        }
+        else {
+            groups.set(el.filePath, [el]);
+        }
+    }
+    return groups;
+}
+/** Convert NamedElements to AnnotationTargets. */
+function toTargets(elements) {
+    return elements.map((el) => ({
+        agentId: el.agentId,
+        line: el.line,
+        column: el.column,
+        type: el.type,
+    }));
+}
+// ---------------------------------------------------------------------------
+// Main command
+// ---------------------------------------------------------------------------
+export async function annotateCommand(args) {
+    const parsed = parseAnnotateArgs(args);
+    if ('error' in parsed) {
+        process.stderr.write(`Error: ${parsed.error}\n`);
+        return 1;
+    }
+    if (parsed.help) {
+        process.stderr.write(ANNOTATE_HELP);
+        return 0;
+    }
+    const manifestPath = path.resolve(parsed.manifest);
+    // Load manifest
+    let manifest;
+    try {
+        const raw = await fs.readFile(manifestPath, 'utf-8');
+        manifest = deserializeManifest(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`Error: Failed to load manifest "${manifestPath}": ${message}\n` +
+            `Run "uicontract scan <dir>" first to generate a manifest, or specify --manifest <path>.\n`);
+        return 1;
+    }
+    if (manifest.elements.length === 0) {
+        if (parsed.json) {
+            process.stdout.write(JSON.stringify({ files: [], totalApplied: 0, totalSkipped: 0 }, null, 2) + '\n');
+        }
+        else {
+            process.stdout.write('No elements to annotate.\n');
+        }
+        return 0;
+    }
+    // Group elements by file
+    const fileGroups = groupByFile(manifest.elements);
+    const results = [];
+    let totalApplied = 0;
+    let totalSkipped = 0;
+    const modifiedFiles = [];
+    const patches = [];
+    for (const [filePath, elements] of fileGroups) {
+        const resolvedPath = path.resolve(filePath);
+        // Read source file
+        let source;
+        try {
+            source = await fs.readFile(resolvedPath, 'utf-8');
+        }
+        catch {
+            process.stderr.write(`Warning: Could not read "${resolvedPath}", skipping.\n`);
+            continue;
+        }
+        const targets = toTargets(elements);
+        const annotationResult = annotateSource(source, targets);
+        if (!annotationResult.modified) {
+            results.push({
+                filePath,
+                annotationsApplied: 0,
+                annotationsSkipped: annotationResult.annotationsSkipped,
+                patch: null,
+            });
+            totalSkipped += annotationResult.annotationsSkipped;
+            continue;
+        }
+        const patch = generatePatch(filePath, source, annotationResult.annotatedSource);
+        patches.push(patch);
+        modifiedFiles.push(resolvedPath);
+        results.push({
+            filePath,
+            annotationsApplied: annotationResult.annotationsApplied,
+            annotationsSkipped: annotationResult.annotationsSkipped,
+            patch,
+        });
+        totalApplied += annotationResult.annotationsApplied;
+        totalSkipped += annotationResult.annotationsSkipped;
+    }
+    // Output results
+    if (parsed.json) {
+        process.stdout.write(JSON.stringify({ files: results, totalApplied, totalSkipped }, null, 2) + '\n');
+    }
+    else if (parsed.write) {
+        // Create backup and write files
+        if (modifiedFiles.length === 0) {
+            process.stdout.write('No files need modification (all annotations already present).\n');
+            return 0;
+        }
+        const backup = await createBackup(modifiedFiles, { backupDir: parsed.backupDir });
+        // Write modified files
+        for (const result of results) {
+            if (result.patch === null)
+                continue;
+            const resolvedPath = path.resolve(result.filePath);
+            await fs.writeFile(resolvedPath, result.patch.modified, 'utf-8');
+        }
+        process.stderr.write(`Annotated ${String(modifiedFiles.length)} file(s)\n` +
+            `  Annotations applied: ${String(totalApplied)}\n` +
+            `  Annotations skipped: ${String(totalSkipped)}\n` +
+            `  Backup: ${backup.backupDir}\n`);
+        // Cleanup backup after successful write
+        await cleanupBackup(backup);
+    }
+    else {
+        // Dry-run: output patches
+        if (patches.length === 0) {
+            process.stdout.write('No changes needed (all annotations already present).\n');
+        }
+        else {
+            for (const patch of patches) {
+                process.stdout.write(patch.diff);
+                process.stdout.write('\n');
+            }
+            process.stderr.write(`\nDry run: ${String(totalApplied)} annotation(s) would be applied across ${String(patches.length)} file(s).\n` +
+                `Run with --write to apply changes.\n`);
+        }
+    }
+    return 0;
+}
+//# sourceMappingURL=annotate.js.map

package/dist/commands/annotate.js.map

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

package/dist/commands/describe.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `uic describe` command — show full details of a single element by agentId.
+ *
+ * stdout: element details (human-readable or JSON)
+ * stderr: logs, errors, help text
+ */
+export declare const DESCRIBE_HELP = "uic describe <agent-id> [options]\n\nShow full details of an interactive UI element by its agent ID.\n\nARGUMENTS\n  <agent-id>             The agent ID of the element to describe\n\nOPTIONS\n  --manifest <path>      Path to manifest file (default: manifest.json)\n  --json                 Output element as JSON\n  --help, -h             Show this help message\n\nEXAMPLES\n  uic describe settings.billing.pause-btn.button\n  uic describe login.email.input --json\n  uic describe nav.home.a --manifest dist/manifest.json\n\nRun \"uicontract --help\" for the full list of commands.\n";
+export interface DescribeArgs {
+    agentId: string | undefined;
+    manifest: string;
+    json: boolean;
+    help: boolean;
+}
+export interface DescribeArgsError {
+    error: string;
+}
+export declare function parseDescribeArgs(args: string[]): DescribeArgs | DescribeArgsError;
+export declare function describeCommand(args: string[]): Promise<number>;
+//# sourceMappingURL=describe.d.ts.map

package/dist/commands/describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/commands/describe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,eAAO,MAAM,aAAa,4kBAmBzB,CAAC;AAMF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,GAAG,iBAAiB,CA2ClF;AAoCD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDrE"}

package/dist/commands/describe.js

@@ -0,0 +1,146 @@
+/**
+ * `uic describe` command — show full details of a single element by agentId.
+ *
+ * stdout: element details (human-readable or JSON)
+ * stderr: logs, errors, help text
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { deserializeManifest } from '@uicontract/core';
+// ---------------------------------------------------------------------------
+// Help text
+// ---------------------------------------------------------------------------
+export const DESCRIBE_HELP = `\
+uic describe <agent-id> [options]
+
+Show full details of an interactive UI element by its agent ID.
+
+ARGUMENTS
+  <agent-id>             The agent ID of the element to describe
+
+OPTIONS
+  --manifest <path>      Path to manifest file (default: manifest.json)
+  --json                 Output element as JSON
+  --help, -h             Show this help message
+
+EXAMPLES
+  uic describe settings.billing.pause-btn.button
+  uic describe login.email.input --json
+  uic describe nav.home.a --manifest dist/manifest.json
+
+Run "uicontract --help" for the full list of commands.
+`;
+export function parseDescribeArgs(args) {
+    let manifest = 'manifest.json';
+    let json = false;
+    let help = false;
+    const positionals = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            help = true;
+            continue;
+        }
+        if (arg === '--json') {
+            json = true;
+            continue;
+        }
+        if (arg === '--manifest') {
+            const next = args[i + 1];
+            if (next === undefined || next.startsWith('-')) {
+                return { error: 'Missing value for --manifest. Example: --manifest manifest.json' };
+            }
+            manifest = next;
+            i++;
+            continue;
+        }
+        if (arg !== undefined && arg.startsWith('-')) {
+            return { error: `Unknown option: ${arg}. Run "uicontract describe --help" for usage.` };
+        }
+        if (arg !== undefined) {
+            positionals.push(arg);
+        }
+    }
+    if (!help && positionals.length === 0) {
+        return { error: 'Missing required argument <agent-id>. Run "uicontract describe --help" for usage.' };
+    }
+    if (positionals.length > 1) {
+        return { error: `Unexpected argument: "${positionals[1] ?? ''}". Only one agent-id is accepted.` };
+    }
+    return { agentId: positionals[0], manifest, json, help };
+}
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+function formatElementDetail(el) {
+    const lines = [
+        `Agent ID:       ${el.agentId}`,
+        `Type:           ${el.type}`,
+        `File:           ${el.filePath}:${String(el.line)}:${String(el.column)}`,
+        `Component:      ${el.componentName ?? '(none)'}`,
+        `Route:          ${el.route ?? '(none)'}`,
+        `Label:          ${el.label !== null ? `"${el.label}"` : '(none)'}`,
+        `Handler:        ${el.handler ?? '(none)'}`,
+        `Conditional:    ${String(el.conditional)}`,
+        `Dynamic:        ${String(el.dynamic)}`,
+    ];
+    const attrKeys = Object.keys(el.attributes);
+    if (attrKeys.length > 0) {
+        lines.push('Attributes:');
+        for (const key of attrKeys) {
+            lines.push(`  ${key}: "${el.attributes[key] ?? ''}"`);
+        }
+    }
+    else {
+        lines.push('Attributes:     (none)');
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Main command
+// ---------------------------------------------------------------------------
+export async function describeCommand(args) {
+    const parsed = parseDescribeArgs(args);
+    if ('error' in parsed) {
+        process.stderr.write(`Error: ${parsed.error}\n`);
+        return 1;
+    }
+    if (parsed.help) {
+        process.stderr.write(DESCRIBE_HELP);
+        return 0;
+    }
+    const agentId = parsed.agentId;
+    const manifestPath = path.resolve(parsed.manifest);
+    let raw;
+    try {
+        raw = await fs.readFile(manifestPath, 'utf-8');
+    }
+    catch {
+        process.stderr.write(`Error: Manifest not found at "${manifestPath}". ` +
+            `Run "uicontract scan <dir>" first to generate a manifest, or specify --manifest <path>.\n`);
+        return 1;
+    }
+    let manifest;
+    try {
+        manifest = deserializeManifest(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`Error: Invalid manifest: ${message}\n`);
+        return 1;
+    }
+    const element = manifest.elements.find((el) => el.agentId === agentId);
+    if (element === undefined) {
+        process.stderr.write(`Error: No element found with agent ID "${agentId}". ` +
+            `Run "uicontract list" to see all available elements, or "uicontract find <query>" to search.\n`);
+        return 1;
+    }
+    if (parsed.json) {
+        process.stdout.write(JSON.stringify(element, null, 2) + '\n');
+    }
+    else {
+        process.stdout.write(formatElementDetail(element) + '\n');
+    }
+    return 0;
+}
+//# sourceMappingURL=describe.js.map

package/dist/commands/describe.js.map

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