anlyx 0.1.3 → 0.1.6-beta.0

package/README.md

@@ -1,13 +1,64 @@
-# anlyx
+# Anlyx
 
-Command line interface for Anlyx.
+CLI for Anlyx Project JSON validation, import, and local viewing.
 
-Published usage:
+Anlyx renders `anlyx.project.json` in a local 4777 viewer:
+
+```txt
+Pages -> Features -> Requests -> Flows -> Architecture -> Evidence
+```
+
+The current primary path is Project JSON first. New setups should start from
+`anlyx.project.json`.
+
+## Quick Start
+
+```bash
+npm install -D anlyx@latest
+npx anlyx prompt init
+npx anlyx validate anlyx.project.json
+npx anlyx import anlyx.project.json
+npx anlyx dev
+```
+
+Then open:
+
+```txt
+http://localhost:4777
+```
+
+## What It Shows
+
+- Pages and page groups authored by the user's AI Agent
+- Features and requests connected to each page
+- Flow summaries from frontend/request/API through backend/data/result layers
+- Architecture Map from agent-authored nodes and edges
+- Evidence labels for observed, measured, source-matched, agent-inferred, manual, not-proven, and unknown claims
+- Timing only when `measurements` exist
+- Raw JSON inspection for `anlyx.project.json`
+
+## Supported
+
+Primary:
+
+- `anlyx.project.json`
+- `.anlyx/project/*.json` split project files
+- `npx anlyx validate <file>`
+- `npx anlyx import <file>`
+- `npx anlyx dev` for the local viewer
+
+## Commands
 
 ```bash
 npx anlyx init
-npx anlyx scan
+npx anlyx prompt init
+npx anlyx prompt refresh
+npx anlyx validate anlyx.project.json
+npx anlyx import anlyx.project.json
 npx anlyx dev
+npx anlyx --help
 ```
 
-See the root Anlyx README for v0.1 usage and scope.
+See the full documentation on GitHub:
+
+https://github.com/suhannoh/anlyx

package/dist/dev-command.d.ts

@@ -1,6 +1,6 @@
-import { type ScanResult } from "@anlyx/core";
+import type { IncomingMessage, ServerResponse } from "node:http";
+import { type ProjectData, type ProjectValidationReport, type ScanResult } from "@anlyx/core";
 import { loadConfig } from "./config-loader.js";
-import { runScanCommand } from "./scan-command.js";
 export type DevCommandOptions = {
     cwd?: string;
     configPath?: string;
@@ -12,17 +12,18 @@ export type DevCommandOptions = {
 export type DevCommandResult = {
     url: string;
     port: number;
+    projectDataPath: string;
     reportDataPath: string;
     mode: "inject" | "overlay" | "viewer";
     frontendUrl?: string;
     scriptTag?: string;
     frontendStarted: boolean;
-    scanRan: boolean;
 };
 export type DevCommandDependencies = {
     loadConfig?: typeof loadConfig;
+    readProjectData?: (path: string) => Promise<ProjectData>;
     readReportData?: (path: string) => Promise<ScanResult>;
-    runScanCommand?: typeof runScanCommand;
+    readValidationReport?: (path: string) => Promise<ProjectValidationReport | undefined>;
     createLocalUiServer?: (options: LocalUiServerOptions) => Promise<LocalUiServer>;
     isFrontendReachable?: (url: string) => Promise<boolean>;
     startFrontendDevServer?: (options: StartFrontendDevServerOptions) => FrontendDevServerProcess;
@@ -30,7 +31,9 @@ export type DevCommandDependencies = {
 };
 export type LocalUiServerOptions = {
     port: number;
-    reportData: ScanResult;
+    projectData?: ProjectData;
+    validationReport?: ProjectValidationReport;
+    reportData?: ScanResult;
     viewerRoot: string;
     frontendBaseUrl: string;
     mode: "inject" | "overlay" | "viewer";
@@ -48,11 +51,19 @@ export type FrontendDevServerProcess = {
 };
 export declare function runDevCommand(options?: DevCommandOptions): Promise<DevCommandResult>;
 export declare function closeActiveLocalUiServers(): Promise<void>;
+export declare function readProjectData(path: string): Promise<ProjectData>;
 export declare function readReportData(path: string): Promise<ScanResult>;
+export declare function readValidationReport(path: string): Promise<ProjectValidationReport | undefined>;
 export declare function createLocalUiServer(options: LocalUiServerOptions): Promise<LocalUiServer>;
 export declare function openBrowser(url: string): Promise<void>;
 export declare function isFrontendReachable(url: string): Promise<boolean>;
 export declare function startFrontendDevServer(options: StartFrontendDevServerOptions): FrontendDevServerProcess;
+export declare function createLiveEventRuntime(reportData: ScanResult): {
+    openStream(request: IncomingMessage, response: ServerResponse): void;
+    recordBrowserRequest(request: IncomingMessage, response: ServerResponse): Promise<void>;
+    recordPageContext(request: IncomingMessage, response: ServerResponse): Promise<void>;
+    recordBackendSpans(request: IncomingMessage, response: ServerResponse): Promise<void>;
+};
 export declare function buildProxyTargetUrl(frontendBaseUrl: string, requestUrl: string): string;
 export declare function injectOverlayScript(html: string): string;
 export declare function getOverlayScriptTag(serverUrl: string): string;

package/dist/dev-command.d.ts.map

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