@tinyviber/a2h 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,570 @@
+/** Broad classification of a scanned file. Extension-driven, least trusted. */
+export type FileKind = 'markdown' | 'code' | 'json' | 'log' | 'diff' | 'image' | 'binary' | 'other';
+/**
+ * How a file's bytes should be drawn. Separate from `Role` on purpose: a role
+ * is what a thing *means* ("spec", "evidence", "draft"), a content kind is what
+ * it *is* ("markdown", "image"). A producer can call a PNG anything it likes and
+ * it will still be drawn as an image.
+ *
+ * Published on the view so a client can decide how to present an artifact
+ * without fetching it first.
+ */
+export type ContentKind = 'markdown' | 'code' | 'json' | 'log' | 'diff' | 'image' | 'file';
+export interface FileEntry {
+    /** POSIX-style path relative to the workspace root, e.g. "outputs/a.md". */
+    path: string;
+    absolutePath: string;
+    kind: FileKind;
+    /** Size in bytes. */
+    size: number;
+    /** Last modified time in epoch ms. */
+    mtimeMs: number;
+    /** Lowercase extension without the leading dot, e.g. "md" ("" if none). */
+    ext: string;
+    isSymlink: boolean;
+    /** Content looks like a secret / credential — do not preview. */
+    sensitive: boolean;
+    /** Directory depth from the workspace root. */
+    depth: number;
+}
+export interface IgnoredEntry {
+    path: string;
+    reason: string;
+}
+export interface GitInfo {
+    isRepo: boolean;
+    branch?: string;
+    lastCommit?: {
+        hash: string;
+        dateMs: number;
+        subject: string;
+    };
+}
+export interface WorkspaceIdentity {
+    /** Human-facing name for the workspace. */
+    name: string;
+    /** One-line summary, typically sourced from the README or git remote. */
+    summary?: string;
+}
+export interface ScanResult {
+    rootDir: string;
+    identity: WorkspaceIdentity;
+    git: GitInfo;
+    files: FileEntry[];
+    ignored: IgnoredEntry[];
+    warnings: string[];
+}
+/**
+ * The built-in (inferred) roles. Producers may use any other string; A2H
+ * treats unknown roles as opaque labels and falls back to a generic card.
+ */
+export type ArtifactKind = 'readme' | 'markdown' | 'report' | 'code' | 'json' | 'log' | 'diff' | 'image' | 'file';
+/**
+ * An open role string. `ArtifactKind | (string & {})` keeps autocomplete for
+ * the built-ins while accepting producer-defined roles such as "signal" or
+ * "test-plan".
+ */
+export type Role = ArtifactKind | (string & {});
+/** How a node's semantics were established. Ordered by trust, highest first. */
+export type SemanticSource = 'explicit' | 'frontmatter' | 'convention' | 'heuristic';
+export interface ArtifactMeta {
+    size: number;
+    mtimeMs: number;
+    /** Lines in the file's own text. Never the number of files touched. */
+    lineCount?: number;
+    /** Files touched by a diff. */
+    fileCount?: number;
+    language?: string;
+    imageWidth?: number;
+    imageHeight?: number;
+}
+/** Built-in fallback sections. Explicit groups may use any string id. */
+export type SectionKind = 'overview' | 'reports' | 'changes' | 'visuals' | 'logs' | 'data' | 'code' | 'other';
+export type RelationKind = 'related' | 'derived-from' | 'supports' | 'supersedes' | 'produced-by';
+export interface Relation {
+    kind: RelationKind | (string & {});
+    /** Workspace-relative path or node id. */
+    target: string;
+    note?: string;
+}
+export interface Metric {
+    label: string;
+    value: string | number;
+    unit?: string;
+    delta?: string;
+    tone?: Tone;
+}
+export type Tone = 'neutral' | 'good' | 'warn' | 'bad' | 'info';
+export interface SemanticNode {
+    /**
+     * Stable id. For artifacts this is the workspace-relative path (unique).
+     * For sections it is a slug such as "reports".
+     */
+    id: string;
+    type: 'workspace' | 'section' | 'group' | 'artifact';
+    title: string;
+    /** Open semantic role. */
+    kind?: Role;
+    /** How the bytes will be drawn, independent of the role. */
+    content?: ContentKind;
+    /** Workspace-relative path (artifacts only). */
+    path?: string;
+    summary?: string;
+    /** Higher = more important / should be shown earlier. */
+    priority: number;
+    meta?: ArtifactMeta;
+    /** Short human tags, e.g. "final", "latest", "stale". */
+    tags?: string[];
+    /** Where the semantics came from. */
+    source?: SemanticSource;
+    /** Producer-declared group id (falls back to the derived section). */
+    group?: string;
+    /** Owning task id, when the producer declared one. */
+    taskId?: string;
+    /** Explicit relations to other artifacts. */
+    relations?: Relation[];
+    /** Producer-declared metrics. */
+    metrics?: Metric[];
+    /** Producer-authored presentation blocks for this artifact. */
+    blocks?: Block[];
+    /**
+     * Which inferred section this artifact belongs to when no producer group
+     * claims it. Derived from the role if it is a built-in one, otherwise from
+     * the file's actual kind — so a producer role never loses basic placement.
+     */
+    fallbackSection?: SectionKind;
+    children: SemanticNode[];
+}
+export interface SemanticIR {
+    /** Stable id for the whole workspace (hash of absolute path). */
+    id: string;
+    identity: WorkspaceIdentity;
+    git: GitInfo;
+    stats: {
+        files: number;
+        artifacts: number;
+        ignored: number;
+        bytes: number;
+    };
+    /** Which semantics layer actually shaped this IR. */
+    semantics: SemanticsOrigin;
+    root: SemanticNode;
+    warnings: string[];
+}
+export type SemanticsOrigin = 'explicit' | 'mixed' | 'inferred';
+/**
+ * Presentation blocks. These are the units the renderer knows how to draw.
+ * A producer can author any of them in the manifest; A2H also synthesises
+ * some from the task/run/action model.
+ *
+ * `type` is an open string so new block kinds can be added without touching
+ * this union's consumers — the client keeps a renderer registry.
+ */
+export interface TextBlock {
+    type: 'text';
+    id?: string;
+    title?: string;
+    text: string;
+    tone?: Tone;
+}
+export interface MarkdownBlock {
+    type: 'markdown';
+    id?: string;
+    title?: string;
+    /**
+     * Server-rendered HTML. Producers never set this — they supply `text` or
+     * `path` and the presentation layer compiles it with the same conservative
+     * renderer used for artifact content.
+     */
+    html?: string;
+    /** Literal markdown source. */
+    text?: string;
+    /** Workspace-relative file to read the markdown from. */
+    path?: string;
+}
+export interface ListItem {
+    title: string;
+    detail?: string;
+    href?: string;
+    status?: TaskStatus | (string & {});
+    meta?: string;
+}
+export interface ListBlock {
+    type: 'list';
+    id?: string;
+    title?: string;
+    items: ListItem[];
+    ordered?: boolean;
+}
+export interface TableBlock {
+    type: 'table';
+    id?: string;
+    title?: string;
+    columns: {
+        key: string;
+        label: string;
+        align?: 'left' | 'right';
+    }[];
+    rows: Record<string, string>[];
+    note?: string;
+}
+export interface ComparisonOption {
+    title: string;
+    summary?: string;
+    facts: {
+        label: string;
+        value: string;
+    }[];
+    tone?: Tone;
+}
+export interface ComparisonBlock {
+    type: 'comparison';
+    id?: string;
+    title?: string;
+    options: ComparisonOption[];
+    conclusion?: string;
+}
+export interface MetricsBlock {
+    type: 'metrics';
+    id?: string;
+    title?: string;
+    items: Metric[];
+}
+export interface TimelineItem {
+    at?: string;
+    title: string;
+    detail?: string;
+    status?: TaskStatus | (string & {});
+}
+export interface TimelineBlock {
+    type: 'timeline';
+    id?: string;
+    title?: string;
+    items: TimelineItem[];
+}
+export interface StatusBlock {
+    type: 'status';
+    id?: string;
+    title?: string;
+    status: TaskStatus | (string & {});
+    detail?: string;
+}
+export interface KeyValueBlock {
+    type: 'keyvalue';
+    id?: string;
+    title?: string;
+    items: {
+        key: string;
+        value: string;
+        mono?: boolean;
+    }[];
+}
+export interface NoticeBlock {
+    type: 'notice';
+    id?: string;
+    title?: string;
+    text: string;
+    tone?: 'info' | 'warn' | 'error';
+}
+export interface ActionsBlock {
+    type: 'actions';
+    id?: string;
+    title?: string;
+    /** Action ids, resolved against the workspace action registry. */
+    ids: string[];
+}
+export type Block = TextBlock | MarkdownBlock | ListBlock | TableBlock | ComparisonBlock | MetricsBlock | TimelineBlock | StatusBlock | KeyValueBlock | NoticeBlock | ActionsBlock | {
+    type: string;
+    id?: string;
+    title?: string;
+    [key: string]: unknown;
+};
+export interface ArtifactView {
+    id: string;
+    title: string;
+    kind: Role;
+    /** How this artifact's bytes will be drawn. Lets the client pick a renderer. */
+    content: ContentKind;
+    path?: string;
+    summary?: string;
+    meta?: ArtifactMeta;
+    tags?: string[];
+    priority: number;
+    source?: SemanticSource;
+    /**
+     * The producer-declared group, when there was one. The section an artifact
+     * appears in is its *home*; the group is the producer's own labelling, which
+     * matters when a section holds more than one group or on a task page.
+     */
+    group?: string;
+    taskId?: string;
+    relations?: Relation[];
+    metrics?: Metric[];
+}
+export interface GroupView {
+    id: string;
+    title: string;
+    description?: string;
+    artifacts: ArtifactView[];
+    taskId?: string;
+}
+export interface SectionView {
+    id: string;
+    title: string;
+    kind: SectionKind | (string & {});
+    description?: string;
+    artifacts: ArtifactView[];
+    /** True when the section came from a producer-declared group. */
+    explicit?: boolean;
+}
+export type TaskStatus = 'pending' | 'running' | 'succeeded' | 'failed' | 'partial' | 'blocked' | 'cancelled' | 'info';
+export interface RunStep {
+    id: string;
+    title: string;
+    status: TaskStatus | (string & {});
+    detail?: string;
+    at?: string;
+}
+export interface RunView {
+    id: string;
+    taskId?: string;
+    title: string;
+    status: TaskStatus | (string & {});
+    startedAt?: string;
+    endedAt?: string;
+    durationMs?: number;
+    summary?: string;
+    /** Workspace-relative paths produced by this run. */
+    artifacts: string[];
+    steps?: RunStep[];
+    blocks?: Block[];
+    /** True when this run is real; false when produced by a mock provider. */
+    simulated?: boolean;
+}
+export interface ActionParam {
+    name: string;
+    label: string;
+    type: 'text' | 'textarea' | 'select' | 'boolean';
+    required?: boolean;
+    options?: string[];
+    placeholder?: string;
+    default?: string | boolean;
+}
+/**
+ * How far an action's effect reaches.
+ *
+ *   none     — navigation only; nothing changes
+ *   state    — changes state A2H can see
+ *   external — would leave this machine (send to an agent, publish, apply a diff)
+ *
+ * Two parties have an opinion about this: the workspace (which hints) and the
+ * executor that will actually run the action (which is authoritative). See
+ * `actions/policy.ts` for the merge — it can only ever raise the level.
+ */
+export type SideEffect = 'none' | 'state' | 'external';
+/**
+ * A provider's authoritative statement about one action: what it will do, and
+ * whether a human must confirm it first.
+ */
+export interface EffectPolicy {
+    effect: SideEffect;
+    /** 'required' means a human must confirm before the action runs. */
+    confirmation: 'required' | 'optional';
+}
+export interface ActionView {
+    id: string;
+    label: string;
+    /** Open kind: approve / reject / retry / run / publish / open / discard … */
+    kind: string;
+    taskId?: string;
+    target?: string;
+    description?: string;
+    /**
+     * How far the side effect reaches — already merged with the executor's own
+     * policy, so this is the *effective* level rather than the workspace's claim.
+     */
+    sideEffect: SideEffect;
+    /** Requires an explicit second confirmation before executing. */
+    confirm: boolean;
+    enabled: boolean;
+    params?: ActionParam[];
+    /**
+     * True when the executor that will run *this* action only simulates it.
+     * Per action, not per workspace: a real provider may own one action while
+     * the built-in simulator owns the next one.
+     */
+    simulated: boolean;
+}
+export interface TaskView {
+    id: string;
+    title: string;
+    status: TaskStatus | (string & {});
+    summary?: string;
+    group?: string;
+    owner?: string;
+    updatedAt?: string;
+    progress?: {
+        done: number;
+        total: number;
+        label?: string;
+    };
+    metrics?: Metric[];
+    blocks?: Block[];
+    /** Artifact ids (workspace-relative paths) belonging to this task. */
+    artifacts: string[];
+    runs: RunView[];
+    actions: ActionView[];
+    source: SemanticSource;
+}
+export interface Presentation {
+    identity: WorkspaceIdentity;
+    git: GitInfo;
+    stats: {
+        files: number;
+        artifacts: number;
+        ignored: number;
+        bytes: number;
+    };
+    /** 'explicit' when a manifest shaped the view; 'inferred' for zero-config. */
+    semantics: SemanticsOrigin;
+    /**
+     * True when at least one declared action will be simulated by its executor.
+     * Deliberately not "all": a workspace may hand one action to a real provider
+     * and let the next fall through to the built-in simulator. Read the per-action
+     * `ActionView.simulated` for anything the human is about to click.
+     */
+    simulatedActions: boolean;
+    highlights: ArtifactView[];
+    sections: SectionView[];
+    tasks: TaskView[];
+    runs: RunView[];
+    actions: ActionView[];
+    /** Workspace-level composed blocks (the "panel"). */
+    panels: Block[];
+    /** Actions attempted in this session. In-memory only; nothing is persisted. */
+    audit: ActionAuditEntry[];
+    warnings: string[];
+}
+/** One line of the session action trail. */
+export interface ActionAuditEntry {
+    at: string;
+    actionId: string;
+    kind: string;
+    sideEffect: string;
+    ok: boolean;
+    simulated: boolean;
+    message: string;
+    executor: string;
+}
+export interface Frontmatter {
+    data: Record<string, unknown>;
+}
+export interface MarkdownContent {
+    type: 'markdown';
+    html: string;
+    title?: string;
+    frontmatter?: Record<string, unknown>;
+}
+export interface CodeContent {
+    type: 'code';
+    language: string;
+    raw: string;
+    totalLines: number;
+    truncated: boolean;
+}
+export interface DiffFile {
+    path: string;
+    from?: string;
+    to?: string;
+    status: 'added' | 'removed' | 'modified' | 'renamed';
+    added: number;
+    removed: number;
+    hunks: DiffHunk[];
+}
+export interface DiffHunk {
+    header: string;
+    lines: DiffLine[];
+}
+export interface DiffLine {
+    type: 'context' | 'add' | 'del';
+    text: string;
+    oldNo?: number;
+    newNo?: number;
+}
+export interface DiffContent {
+    type: 'diff';
+    files: DiffFile[];
+    totalLines: number;
+    truncated?: boolean;
+}
+export interface JsonContent {
+    type: 'json';
+    data: unknown;
+    valid: boolean;
+    /** Raw text, possibly truncated. */
+    raw: string;
+    truncated: boolean;
+}
+export interface LogContent {
+    type: 'log';
+    tail: string[];
+    totalLines: number;
+    truncated: boolean;
+    hasErrors: boolean;
+    hasWarnings: boolean;
+    /** Zero-based line numbers (of the full log) that contain errors. */
+    errorLines: number[];
+}
+export interface ImageContent {
+    type: 'image';
+    url: string;
+    width?: number;
+    height?: number;
+}
+export interface FileContent {
+    type: 'file';
+    isBinary: boolean;
+    /** Short text preview for text files (truncated). */
+    text?: string;
+    truncated?: boolean;
+    /** Optional note, e.g. "sensitive" or "symlink". */
+    note?: string;
+}
+export type ArtifactContent = MarkdownContent | CodeContent | DiffContent | JsonContent | LogContent | ImageContent | FileContent;
+export interface ArtifactPayload {
+    id: string;
+    title: string;
+    kind: Role;
+    path?: string;
+    summary?: string;
+    meta?: ArtifactMeta;
+    tags?: string[];
+    content: ArtifactContent;
+    /** Producer-authored blocks, pre-resolved for rendering. */
+    blocks?: Block[];
+    relations?: Relation[];
+    taskId?: string;
+}
+export interface ActionRequest {
+    id: string;
+    params?: Record<string, string>;
+    /** Set by the client after the user confirms a side-effecting action. */
+    confirm?: boolean;
+}
+export interface ActionResult {
+    ok: boolean;
+    actionId: string;
+    /** Human-readable outcome line. */
+    message: string;
+    /** True when a mock provider produced this result. */
+    simulated: boolean;
+    /** Run created by the action, when the executor produced one. */
+    run?: RunView;
+    /** Task whose state changed, with its new status. */
+    task?: {
+        id: string;
+        status: string;
+    };
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,19 @@
+"use strict";
+// A2H core types.
+//
+// These types form the contract between the scanner, semantics resolver,
+// semantic IR builder, presentation layer, content renderers, action
+// executors, and the local server. They are deliberately framework-free:
+// nothing here imports React or any renderer.
+//
+// The layering, in order:
+//
+//   filesystem
+//     -> scanner            (FileEntry: what bytes exist)
+//     -> semantics          (explicit manifest / frontmatter / conventions)
+//     -> semantic IR        (SemanticNode: what things mean)
+//     -> presentation IR    (Presentation: what a human should see, in order)
+//     -> renderer           (ArtifactContent + Block payloads)
+//     -> local web UI
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,kBAAkB;AAClB,EAAE;AACF,yEAAyE;AACzE,qEAAqE;AACrE,yEAAyE;AACzE,8CAA8C;AAC9C,EAAE;AACF,0BAA0B;AAC1B,EAAE;AACF,eAAe;AACf,0DAA0D;AAC1D,4EAA4E;AAC5E,6DAA6D;AAC7D,8EAA8E;AAC9E,+DAA+D;AAC/D,sBAAsB"}

package/dist/util/path.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Normalizes a POSIX relative path, resolving "." and ".." segments.
+ * Returns null if the path escapes the root (i.e. climbs above it).
+ */
+export declare function normalizeRel(p: string): string | null;
+/**
+ * Joins a base directory with a relative path and normalizes the result.
+ * Returns null if the result escapes the workspace root.
+ */
+export declare function joinRel(baseDir: string, rel: string): string | null;
+//# sourceMappingURL=path.d.ts.map

package/dist/util/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/util/path.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYrD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEnE"}

package/dist/util/path.js

@@ -0,0 +1,35 @@
+"use strict";
+// Path helpers that are used by both the renderer (image resolution) and the
+// server (route safety). They produce workspace-relative POSIX paths and
+// reject anything that would escape the workspace root.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeRel = normalizeRel;
+exports.joinRel = joinRel;
+/**
+ * Normalizes a POSIX relative path, resolving "." and ".." segments.
+ * Returns null if the path escapes the root (i.e. climbs above it).
+ */
+function normalizeRel(p) {
+    const segs = [];
+    for (const seg of p.split('/')) {
+        if (seg === '' || seg === '.')
+            continue;
+        if (seg === '..') {
+            if (segs.length === 0)
+                return null;
+            segs.pop();
+        }
+        else {
+            segs.push(seg);
+        }
+    }
+    return segs.join('/');
+}
+/**
+ * Joins a base directory with a relative path and normalizes the result.
+ * Returns null if the result escapes the workspace root.
+ */
+function joinRel(baseDir, rel) {
+    return normalizeRel(baseDir ? `${baseDir}/${rel}` : rel);
+}
+//# sourceMappingURL=path.js.map

package/dist/util/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/util/path.ts"],"names":[],"mappings":";AAAA,6EAA6E;AAC7E,yEAAyE;AACzE,wDAAwD;;AAMxD,oCAYC;AAMD,0BAEC;AAxBD;;;GAGG;AACH,SAAgB,YAAY,CAAC,CAAS;IACpC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,GAAG;YAAE,SAAS;QACxC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACnC,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,SAAgB,OAAO,CAAC,OAAe,EAAE,GAAW;IAClD,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC"}