@tinyviber/a2h 0.1.0

package/dist/semantics/resolve.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSemantics = resolveSemantics;
+const policy_1 = require("../actions/policy");
+function resolveSemantics(loaded, options) {
+    const items = new Map();
+    const warnings = [...loaded.warnings];
+    // 1) Manifest items (most explicit).
+    for (const spec of loaded.itemSpecs) {
+        const key = normalize(spec.path);
+        if (!key)
+            continue;
+        const existing = items.get(key);
+        const next = {
+            role: spec.role ?? existing?.role,
+            title: spec.title ?? existing?.title,
+            summary: spec.summary ?? existing?.summary,
+            group: spec.group ?? existing?.group,
+            taskId: spec.taskId ?? existing?.taskId,
+            priority: spec.priority ?? existing?.priority,
+            tags: spec.tags ?? existing?.tags,
+            hidden: spec.hidden ?? existing?.hidden,
+            relations: spec.relations ?? existing?.relations,
+            metrics: spec.metrics ?? existing?.metrics,
+            blocks: spec.blocks ?? existing?.blocks,
+            source: 'explicit',
+        };
+        items.set(key, next);
+    }
+    // 2) Frontmatter fills whatever the manifest left open.
+    for (const [path, fm] of loaded.frontmatter) {
+        const key = normalize(path);
+        if (!key)
+            continue;
+        const existing = items.get(key);
+        const next = {
+            role: existing?.role ?? fm.role,
+            title: existing?.title ?? fm.title,
+            summary: existing?.summary ?? fm.summary,
+            group: existing?.group ?? fm.group,
+            taskId: existing?.taskId ?? fm.taskId,
+            priority: existing?.priority ?? fm.priority,
+            tags: existing?.tags ?? fm.tags,
+            hidden: existing?.hidden ?? fm.hidden,
+            relations: existing?.relations,
+            metrics: existing?.metrics,
+            blocks: existing?.blocks,
+            source: existing?.source ?? 'frontmatter',
+        };
+        items.set(key, next);
+    }
+    const actions = loaded.actionSpecs.map((a) => toActionView(a, options.resolveAction));
+    const actionById = new Map(actions.map((a) => [a.id, a]));
+    const runs = dedupeRuns(loaded.runSpecs).map(toRunView);
+    const tasks = loaded.taskSpecs.map((t) => {
+        const attached = new Set(t.actions ?? []);
+        for (const a of actions)
+            if (a.taskId === t.id)
+                attached.add(a.id);
+        return {
+            id: t.id,
+            title: t.title ?? t.id,
+            status: normalizeStatus(t.status),
+            summary: t.summary,
+            group: t.group,
+            owner: t.owner,
+            updatedAt: t.updatedAt,
+            progress: t.progress,
+            metrics: t.metrics,
+            blocks: t.blocks,
+            artifacts: [...(t.artifacts ?? [])],
+            runs: runs.filter((r) => r.taskId === t.id),
+            actions: [...attached].map((id) => actionById.get(id)).filter(isPresent),
+            source: 'explicit',
+        };
+    });
+    const origin = loaded.manifest
+        ? tasks.length || items.size || loaded.groupSpecs.length
+            ? 'explicit'
+            : 'mixed'
+        : items.size || runs.length
+            ? 'mixed'
+            : 'inferred';
+    if (actions.length > 0) {
+        const simulated = actions.filter((a) => a.simulated).length;
+        if (simulated === actions.length) {
+            warnings.push(`${simulated} action(s) are backed by the built-in simulator — no external agent is connected.`);
+        }
+        else if (simulated > 0) {
+            warnings.push(`${simulated} of ${actions.length} action(s) fall through to the built-in simulator; the rest are handled by a connected provider.`);
+        }
+    }
+    return {
+        origin,
+        name: loaded.name,
+        summary: loaded.summary,
+        items,
+        groups: sortGroups(loaded.groupSpecs),
+        tasks,
+        runs,
+        actions,
+        panels: loaded.panels,
+        warnings,
+    };
+}
+// ---------------------------------------------------------------------------
+/**
+ * Builds the client-facing action view.
+ *
+ * The workspace's declaration is a hint; the executor's policy is
+ * authoritative; the effective value is the stricter of the two. Doing the
+ * merge here (rather than trusting the manifest's own `sideEffect`/`confirm`)
+ * is what stops a workspace from labelling a publish as a no-op.
+ */
+function toActionView(spec, resolve) {
+    const declared = {
+        id: spec.id,
+        label: spec.label,
+        kind: spec.kind ?? 'custom',
+        taskId: spec.taskId,
+        target: spec.target,
+        description: spec.description,
+        sideEffect: spec.sideEffect ?? 'state',
+        confirm: false,
+        enabled: spec.enabled ?? true,
+        params: spec.params?.map((p) => ({
+            name: p.name,
+            label: p.label ?? p.name,
+            type: p.type ?? 'text',
+            required: p.required,
+            options: p.options,
+            placeholder: p.placeholder,
+            default: p.default,
+        })),
+        simulated: true,
+    };
+    const hint = (0, policy_1.policyFromHint)(spec.sideEffect, spec.confirm);
+    const provenance = resolve?.(declared);
+    const effective = provenance ? (0, policy_1.stricterPolicy)(hint, provenance.policy) : hint;
+    return {
+        ...declared,
+        sideEffect: effective.effect,
+        confirm: effective.confirmation === 'required',
+        simulated: provenance ? provenance.simulated : true,
+    };
+}
+function toRunView(spec) {
+    const started = parseTime(spec.startedAt);
+    const ended = parseTime(spec.endedAt);
+    const durationMs = spec.durationMs ?? (started !== undefined && ended !== undefined ? Math.max(0, ended - started) : undefined);
+    return {
+        id: spec.id,
+        taskId: spec.taskId,
+        title: spec.title ?? spec.id,
+        status: normalizeStatus(spec.status),
+        startedAt: spec.startedAt,
+        endedAt: spec.endedAt,
+        durationMs,
+        summary: spec.summary,
+        artifacts: spec.artifacts ?? [],
+        steps: spec.steps?.map((s, i) => ({
+            id: s.id ?? `step-${i + 1}`,
+            title: s.title,
+            status: normalizeStatus(s.status),
+            detail: s.detail,
+            at: s.at,
+        })),
+        blocks: spec.blocks,
+        simulated: false,
+    };
+}
+function dedupeRuns(specs) {
+    const byId = new Map();
+    for (const s of specs) {
+        if (!byId.has(s.id))
+            byId.set(s.id, s);
+    }
+    return [...byId.values()].sort((a, b) => {
+        const ta = parseTime(a.startedAt) ?? 0;
+        const tb = parseTime(b.startedAt) ?? 0;
+        return tb - ta;
+    });
+}
+function sortGroups(groups) {
+    return groups
+        .map((g, i) => ({ g, i }))
+        .sort((a, b) => (a.g.order ?? a.i) - (b.g.order ?? b.i) || a.i - b.i)
+        .map((x) => x.g);
+}
+/**
+ * Producer statuses are open strings. Well-known ones get dedicated styling;
+ * anything else still renders with a neutral treatment.
+ */
+function normalizeStatus(status) {
+    if (!status)
+        return 'pending';
+    return status;
+}
+function parseTime(value) {
+    if (!value)
+        return undefined;
+    const ms = Date.parse(value);
+    return Number.isFinite(ms) ? ms : undefined;
+}
+function normalize(p) {
+    return p.replace(/\\/g, '/').replace(/^\.\//, '').replace(/\/+$/, '').trim();
+}
+function isPresent(v) {
+    return v != null;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/semantics/resolve.js.map

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

package/dist/semantics/types.d.ts

@@ -0,0 +1,158 @@
+import type { Block, Metric, Relation, SideEffect, TaskStatus } from '../types';
+export interface GroupSpec {
+    id: string;
+    title?: string;
+    description?: string;
+    /** Sort hint for the group, ascending. */
+    order?: number;
+    taskId?: string;
+}
+export interface ProgressSpec {
+    done: number;
+    total: number;
+    label?: string;
+}
+export interface TaskSpec {
+    id: string;
+    title?: string;
+    status?: TaskStatus | (string & {});
+    summary?: string;
+    group?: string;
+    owner?: string;
+    updatedAt?: string;
+    progress?: ProgressSpec;
+    metrics?: Metric[];
+    blocks?: Block[];
+    /** Action ids attached to this task. */
+    actions?: string[];
+    /** Workspace-relative artifact paths belonging to this task. */
+    artifacts?: string[];
+}
+export interface RunStepSpec {
+    id?: string;
+    title: string;
+    status?: TaskStatus | (string & {});
+    detail?: string;
+    at?: string;
+}
+export interface RunSpec {
+    id: string;
+    taskId?: string;
+    title?: string;
+    status?: TaskStatus | (string & {});
+    startedAt?: string;
+    endedAt?: string;
+    durationMs?: number;
+    summary?: string;
+    artifacts?: string[];
+    steps?: RunStepSpec[];
+    blocks?: Block[];
+}
+/** Shape of a file in `.a2h/runs/`. Either a single run or `{ runs: [...] }`. */
+export type RunSpecFile = RunSpec | {
+    runs: RunSpec[];
+};
+export interface ActionParamSpec {
+    name: string;
+    label?: string;
+    type?: 'text' | 'textarea' | 'select' | 'boolean';
+    required?: boolean;
+    options?: string[];
+    placeholder?: string;
+    default?: string | boolean;
+}
+export interface ActionSpec {
+    id: string;
+    label: string;
+    kind?: string;
+    taskId?: string;
+    target?: string;
+    description?: string;
+    /**
+     * 'none'   — pure navigation / client-side
+     * 'state'  — changes A2H-visible state only
+     * 'external' — would leave A2H (send to agent, publish, apply diff)
+     * Defaults to 'state', the conservative middle ground.
+     *
+     * This is a *hint*. The executor that will run the action states the
+     * authoritative policy, and the two are merged with the stricter one
+     * winning — a workspace can escalate, never relax.
+     */
+    sideEffect?: SideEffect;
+    /** Ask for confirmation even when the effective policy would not require it. */
+    confirm?: boolean;
+    params?: ActionParamSpec[];
+    /** Set false to render the action as unavailable. */
+    enabled?: boolean;
+}
+export interface ItemSpec {
+    path: string;
+    role?: string;
+    title?: string;
+    summary?: string;
+    group?: string;
+    taskId?: string;
+    priority?: number;
+    tags?: string[];
+    hidden?: boolean;
+    relations?: Relation[];
+    metrics?: Metric[];
+    blocks?: Block[];
+}
+export interface Manifest {
+    /** Protocol version. Absent is treated as 1. */
+    a2h?: number;
+    name?: string;
+    summary?: string;
+    groups?: GroupSpec[];
+    tasks?: TaskSpec[];
+    runs?: RunSpec[];
+    actions?: ActionSpec[];
+    items?: ItemSpec[];
+    /** Workspace-level composed blocks shown above the sections. */
+    panels?: Block[];
+}
+/** Per-artifact semantics after merging manifest + frontmatter. */
+export interface ResolvedItem {
+    role?: string;
+    title?: string;
+    summary?: string;
+    group?: string;
+    taskId?: string;
+    priority?: number;
+    tags?: string[];
+    hidden?: boolean;
+    relations?: Relation[];
+    metrics?: Metric[];
+    blocks?: Block[];
+    /** Which layer supplied these semantics. */
+    source: 'explicit' | 'frontmatter';
+}
+/** Producer metadata parsed out of a markdown frontmatter block. */
+export interface FrontmatterSemantics {
+    role?: string;
+    title?: string;
+    summary?: string;
+    group?: string;
+    taskId?: string;
+    status?: string;
+    priority?: number;
+    tags?: string[];
+    hidden?: boolean;
+}
+export interface LoadedSemantics {
+    manifest?: Manifest;
+    /** Path the manifest was read from, relative to the root. */
+    manifestPath?: string;
+    taskSpecs: TaskSpec[];
+    runSpecs: RunSpec[];
+    actionSpecs: ActionSpec[];
+    itemSpecs: ItemSpec[];
+    groupSpecs: GroupSpec[];
+    panels?: Block[];
+    frontmatter: Map<string, FrontmatterSemantics>;
+    name?: string;
+    summary?: string;
+    warnings: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/semantics/types.d.ts.map

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

package/dist/semantics/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/semantics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/semantics/types.ts"],"names":[],"mappings":""}

package/dist/server/server.d.ts

@@ -0,0 +1,17 @@
+import { type IncomingMessage, type ServerResponse } from 'node:http';
+import type { Workspace } from './workspace';
+export interface ServerOptions {
+    workspace: Workspace;
+    host?: string;
+    onListening?: (url: string) => void;
+    assetsDir?: string;
+    /** Overrides the per-process session token. Tests use this; nothing else should. */
+    sessionToken?: string;
+}
+export declare function findAssetsDir(): string;
+export declare function createA2hServer(options: ServerOptions): {
+    server: import("http").Server<typeof IncomingMessage, typeof ServerResponse>;
+    broadcast: (event: string) => void;
+    host: string;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAEpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA2F7C,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa;;uBAe1B,MAAM,KAAG,IAAI;;EA4MxC"}