@software-dlc/cli 0.157.2

package/dist/local/workspace-environment-runtime.js

@@ -0,0 +1,135 @@
+export class LocalWorkspaceEnvironmentRuntime {
+    store;
+    authority;
+    resolver_store;
+    remote_store;
+    remote_fetcher;
+    remote_pusher;
+    remote_topic_publisher;
+    remote_pull_request_creator;
+    portable_authoring;
+    constructor(store, authority, resolver_store, remote_store, remote_fetcher, remote_pusher, remote_topic_publisher, remote_pull_request_creator, portable_authoring) {
+        this.store = store;
+        this.authority = authority;
+        this.resolver_store = resolver_store;
+        this.remote_store = remote_store;
+        this.remote_fetcher = remote_fetcher;
+        this.remote_pusher = remote_pusher;
+        this.remote_topic_publisher = remote_topic_publisher;
+        this.remote_pull_request_creator = remote_pull_request_creator;
+        this.portable_authoring = portable_authoring;
+    }
+    resolverStatus() {
+        return this.resolver_store.status();
+    }
+    async configureResolver(input) {
+        await this.requireHuman(input.actor_workspace_id);
+        return this.resolver_store.configure(input.configuration);
+    }
+    async configureResolverFromFile(input) {
+        await this.requireHuman(input.actor_workspace_id);
+        return this.resolver_store.configureFromFile(input.path);
+    }
+    async clearResolver(input) {
+        await this.requireHuman(input.actor_workspace_id);
+        return this.resolver_store.clear();
+    }
+    async loadResolver(input) {
+        await this.authority.requireCurrent(input.actor_workspace_id);
+        return this.resolver_store.load({
+            allow_network_resolver: input.allow_network_resolver
+        });
+    }
+    listRemotes() {
+        return this.remote_store.list();
+    }
+    inspectRemote(name) {
+        return this.remote_store.inspect(name);
+    }
+    async setRemote(input) {
+        await this.requireHuman(input.actor_workspace_id);
+        return this.remote_store.set(input.remote);
+    }
+    async removeRemote(input) {
+        await this.requireHuman(input.actor_workspace_id);
+        return this.remote_store.remove(input.name);
+    }
+    async discoverRemote(input) {
+        await this.authority.requireCurrent(input.actor_workspace_id);
+        return this.remote_store.discover({
+            name: input.name,
+            fetch_impl: input.fetch_impl,
+            timeout_ms: input.timeout_ms
+        });
+    }
+    listRemoteTrackingRefs(name) {
+        return this.store.remote_tracking.listRefs(name);
+    }
+    async fetchRemote(input) {
+        await this.authority.requireCurrent(input.actor_workspace_id);
+        return this.remote_fetcher.fetch(input);
+    }
+    listRemotePushJournals(name) {
+        return this.store.remote_push.listJournals(name);
+    }
+    listRemoteTopicJournals(name) {
+        return this.store.remote_topic.listJournals(name);
+    }
+    listRemotePullRequestJournals(name) {
+        return this.store.remote_pull_request.listJournals(name);
+    }
+    async planPortableHistory(input) {
+        const { workspace } = await this.authority.requireCurrent(input.actor_workspace_id);
+        return this.portable_authoring.plan(input.local_commit_id ?? workspace.head_sdlc_commit_id);
+    }
+    async convertPortableHistory(input) {
+        const { workspace } = await this.authority.requireCurrent(input.actor_workspace_id, { require_human: true });
+        return this.portable_authoring.convert({
+            head_local_commit_id: input.local_commit_id ?? workspace.head_sdlc_commit_id,
+            identity_file: input.identity_file,
+            base_remote_name: input.base_remote_name,
+            base_source_ref: input.base_source_ref
+        });
+    }
+    async pushRemote(input) {
+        const { workspace } = await this.authority.requireCurrent(input.actor_workspace_id, { require_human: true });
+        const new_commit_id = input.new_commit_id ??
+            this.store.portable_commits.getLocalMapping(workspace.head_sdlc_commit_id);
+        if (!new_commit_id) {
+            throw new Error('The current workspace head has no portable mapping. Convert it with explicit identity claims before pushing or pass --commit.');
+        }
+        return this.remote_pusher.push({
+            name: input.name,
+            destination_ref: input.destination_ref,
+            new_commit_id,
+            fetch_impl: input.fetch_impl,
+            timeout_ms: input.timeout_ms
+        });
+    }
+    async publishRemoteTopic(input) {
+        const { workspace } = await this.authority.requireCurrent(input.actor_workspace_id, { require_human: true });
+        const new_commit_id = input.new_commit_id ??
+            this.store.portable_commits.getLocalMapping(workspace.head_sdlc_commit_id);
+        if (!new_commit_id) {
+            throw new Error('The current workspace head has no portable mapping. Convert it with explicit identity claims before publishing a topic or pass --commit.');
+        }
+        return this.remote_topic_publisher.publish({
+            name: input.name,
+            topic_ref: input.topic_ref,
+            target_ref: input.target_ref,
+            new_commit_id,
+            fetch_impl: input.fetch_impl,
+            timeout_ms: input.timeout_ms
+        });
+    }
+    async createRemotePullRequest(input) {
+        await this.authority.requireCurrent(input.actor_workspace_id, {
+            require_human: true
+        });
+        return this.remote_pull_request_creator.create(input);
+    }
+    async requireHuman(workspace_id) {
+        await this.authority.requireCurrent(workspace_id, { require_human: true });
+    }
+}
+//# sourceMappingURL=workspace-environment-runtime.js.map

package/dist/local/workspace-environment-runtime.js.map

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

package/dist/local/workspace-evidence-drop.d.ts

@@ -0,0 +1,21 @@
+import type { PortableGraph } from '@software-dlc/graph/types';
+import { type EvidenceEntityKind } from './workspace-evidence-status.js';
+/**
+ * Source references an entity had at the base and no longer has. An agent
+ * that writes an entity file again from scratch drops its `data.meta.evidence`
+ * without meaning to, so a commit reports the loss instead of staying silent.
+ * Removing a reference on purpose is valid, so this warns and never refuses.
+ * An entity the commit removes is not counted: its references go with it.
+ */
+export type LocalEvidenceDrop = {
+    entity_kind: EvidenceEntityKind;
+    entity_id: string;
+    dropped_reference_ids: string[];
+};
+export declare function droppedEvidenceReferences(input: {
+    base_graph: PortableGraph;
+    graph: PortableGraph;
+}): LocalEvidenceDrop[];
+/** One commit warning for the drops, or none. */
+export declare function evidenceDropWarning(drops: LocalEvidenceDrop[]): string | null;
+//# sourceMappingURL=workspace-evidence-drop.d.ts.map

package/dist/local/workspace-evidence-drop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-evidence-drop.d.ts","sourceRoot":"","sources":["../../src/local/workspace-evidence-drop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,kBAAkB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC,CAAC;AAoBF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,UAAU,EAAE,aAAa,CAAC;IAC1B,KAAK,EAAE,aAAa,CAAC;CACtB,GAAG,iBAAiB,EAAE,CAsCtB;AAID,iDAAiD;AACjD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,GAAG,IAAI,CAiB7E"}

package/dist/local/workspace-evidence-drop.js

@@ -0,0 +1,58 @@
+import { hashEvidenceReferenceIdentity } from '@software-dlc/graph/schema';
+import { entityEvidence } from './workspace-evidence-status.js';
+function references(entity) {
+    return entityEvidence(entity)?.references ?? [];
+}
+/**
+ * Each reference's id and identity hash. `sdlc-agents sources record`
+ * replaces a reference with the same identity under a new id, which is not
+ * a loss.
+ */
+function referenceKeys(entity) {
+    return new Set(references(entity).flatMap((reference) => [
+        reference.reference_id,
+        hashEvidenceReferenceIdentity(reference)
+    ]));
+}
+export function droppedEvidenceReferences(input) {
+    const drops = [];
+    const compare = (entity_kind, base, current) => {
+        const now = new Map(current.map((entity) => [entity.id, entity]));
+        for (const before of base) {
+            const after = now.get(before.id);
+            if (!after)
+                continue;
+            const kept = referenceKeys(after);
+            const dropped = references(before)
+                .filter((reference) => !kept.has(reference.reference_id) &&
+                !kept.has(hashEvidenceReferenceIdentity(reference)))
+                .map((reference) => reference.reference_id);
+            if (dropped.length > 0)
+                drops.push({
+                    entity_kind,
+                    entity_id: before.id,
+                    dropped_reference_ids: dropped
+                });
+        }
+    };
+    compare('node', input.base_graph.nodes, input.graph.nodes);
+    compare('edge', input.base_graph.edges, input.graph.edges);
+    return drops;
+}
+const NAMED = 5;
+/** One commit warning for the drops, or none. */
+export function evidenceDropWarning(drops) {
+    if (drops.length === 0)
+        return null;
+    const references = drops.reduce((total, drop) => total + drop.dropped_reference_ids.length, 0);
+    const named = drops
+        .slice(0, NAMED)
+        .map((drop) => `${drop.entity_kind} ${drop.entity_id}`)
+        .join(', ');
+    const more = drops.length > NAMED ? ` and ${drops.length - NAMED} more` : '';
+    return (`${references} source reference${references === 1 ? '' : 's'} dropped from ` +
+        `${drops.length} entit${drops.length === 1 ? 'y' : 'ies'} the commit keeps ` +
+        `(${named}${more}). Rewriting an entity file drops its data.meta.evidence; ` +
+        `keep that block when editing, or record the sources again with sdlc-agents sources record.`);
+}
+//# sourceMappingURL=workspace-evidence-drop.js.map

package/dist/local/workspace-evidence-drop.js.map

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

package/dist/local/workspace-evidence-sign-tool.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import type { EvidenceSignResult } from './workspace-evidence.js';
+export declare const evidence_sign_arguments_schema: z.ZodObject<{
+    nodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    edges: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    references: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    changed: z.ZodOptional<z.ZodBoolean>;
+    commit: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type EvidenceSignRead = EvidenceSignResult | {
+    version: 1;
+    error: string;
+};
+export declare function signWorkspaceEvidence(input: {
+    cwd: string;
+    arguments: unknown;
+    /** The repository state directory, when not the checkout's own. */
+    state_dir?: string;
+}): Promise<EvidenceSignRead>;
+//# sourceMappingURL=workspace-evidence-sign-tool.d.ts.map

package/dist/local/workspace-evidence-sign-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-evidence-sign-tool.d.ts","sourceRoot":"","sources":["../../src/local/workspace-evidence-sign-tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAclE,eAAO,MAAM,8BAA8B;;;;;;kBAkBxC,CAAC;AAEJ,MAAM,MAAM,gBAAgB,GACxB,kBAAkB,GAClB;IAAE,OAAO,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+D5B"}

package/dist/local/workspace-evidence-sign-tool.js

@@ -0,0 +1,85 @@
+import { stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { discoverGitWorktree } from './git.js';
+import { resolveLocalRepositoryStateDirectory } from './workspace-graph-store.js';
+import { LocalWorkspaceRuntime } from './workspace-runtime.js';
+import { readWorkspaceTopology } from './workspace-topology.js';
+/**
+ * Sign-off for agents (the `sdlc_evidence_sign` MCP tool): `sdlc workspace
+ * evidence sign` for the local workspace at a checkout, its arguments checked
+ * strictly. Offline. It writes only that workspace's projection (and widens
+ * its task scope), never commits, and never creates a store.
+ */
+const id = z.string().trim().min(1).max(200);
+export const evidence_sign_arguments_schema = z
+    .object({
+    nodes: z.array(id).max(200).optional(),
+    edges: z.array(id).max(200).optional(),
+    references: z.array(id).max(200).optional(),
+    changed: z.boolean().optional(),
+    commit: z.string().trim().min(1).max(200).optional()
+})
+    .strict()
+    .refine((value) => Boolean(value.nodes?.length ||
+    value.edges?.length ||
+    value.references?.length ||
+    value.changed), { message: 'name what to sign: nodes, edges, references, or changed' });
+export async function signWorkspaceEvidence(input) {
+    const parsed = evidence_sign_arguments_schema.safeParse(input.arguments ?? {});
+    if (!parsed.success) {
+        return {
+            version: 1,
+            error: `Invalid arguments: ${parsed.error.issues
+                .map((issue) => `${issue.path.join('.') || '(arguments)'} ${issue.message}`)
+                .join('; ')}`
+        };
+    }
+    const args = parsed.data;
+    let runtime = null;
+    try {
+        const git = await discoverGitWorktree(input.cwd);
+        const topology = await readWorkspaceTopology(git.repository_root);
+        const state_dir = resolveLocalRepositoryStateDirectory({
+            git_common_dir: git.git_common_dir,
+            override: input.state_dir ?? topology?.state_dir
+        });
+        if (!(await stat(join(state_dir, 'repository.sqlite')).catch(() => null))) {
+            return {
+                version: 1,
+                error: 'This repository has no local workspace store, so it has no evidence to sign.'
+            };
+        }
+        runtime = await LocalWorkspaceRuntime.open({
+            cwd: input.cwd,
+            state_dir: input.state_dir
+        });
+        const workspace = runtime.store.getWorkspaceByGitWorktreePath(runtime.git.repository_root);
+        if (!workspace || workspace.status !== 'active') {
+            return {
+                version: 1,
+                error: 'This checkout is not an active local workspace, so it has no evidence to sign.'
+            };
+        }
+        return await runtime.signEvidence({
+            actor_workspace_id: workspace.id,
+            nodes: args.nodes,
+            edges: args.edges,
+            references: args.references,
+            changed: args.changed,
+            commit: args.commit
+        });
+    }
+    catch (error) {
+        return {
+            version: 1,
+            error: error instanceof Error
+                ? error.message
+                : 'The evidence could not be signed.'
+        };
+    }
+    finally {
+        runtime?.close();
+    }
+}
+//# sourceMappingURL=workspace-evidence-sign-tool.js.map

package/dist/local/workspace-evidence-sign-tool.js.map

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

package/dist/local/workspace-evidence-status.d.ts

@@ -0,0 +1,89 @@
+import { type EvidenceClaimFreshness } from '@software-dlc/graph/schema';
+import type { C4EvidenceReferenceSetV1, PortableGraph } from '@software-dlc/graph/types';
+/**
+ * Claim freshness, locally (docs/specs/evidence-claim-freshness.md): whether
+ * each node's and edge's evidence was checked against the claim as it reads
+ * now. Each entity is hashed from the projection's own content. Graph only.
+ */
+export type EvidenceEntityKind = 'node' | 'edge';
+export type EvidenceEntity = {
+    id: string;
+    type?: unknown;
+    parentId?: unknown;
+    source?: unknown;
+    target?: unknown;
+    data?: {
+        data?: unknown;
+        meta?: unknown;
+    } & Record<string, unknown>;
+};
+/**
+ * An entity's raw sync object hash, computed from its content: never the
+ * stored `data.object_hash`, which a projection file may hold stale.
+ */
+export declare function entityObjectHash(kind: EvidenceEntityKind, entity: EvidenceEntity): string;
+/** The entity's evidence on the current contract; legacy evidence is read as its upcast. */
+export declare function entityEvidence(entity: EvidenceEntity): C4EvidenceReferenceSetV1 | undefined;
+/** behind when any counted reference is behind, else current when any is current, else unpinned. */
+export declare function entityFreshness(references: Array<{
+    freshness: EvidenceClaimFreshness;
+    counted: boolean;
+}>): EvidenceClaimFreshness;
+export type EvidenceReferenceFreshness = {
+    reference_id: string;
+    provider_key: string;
+    resource: string;
+    anchor: string | null;
+    /** Its own review status, else its set's, as the Evidence Inspector reads it. */
+    review_status: string | null;
+    claim_object_hash: string | null;
+    freshness: EvidenceClaimFreshness;
+    /** Whether it decides its entity's freshness: its review_status (its own, else its set's) is accepted, or there is none. */
+    counted: boolean;
+};
+export type EvidenceEntityStatus = {
+    kind: EvidenceEntityKind;
+    id: string;
+    type: string | null;
+    label: string | null;
+    object_hash: string;
+    freshness: EvidenceClaimFreshness;
+    references: EvidenceReferenceFreshness[];
+};
+/** One entity's claim freshness, or null when it carries no evidence. */
+export declare function entityEvidenceStatus(kind: EvidenceEntityKind, entity: EvidenceEntity): EvidenceEntityStatus | null;
+/** The references that put an entity behind its claim. */
+export declare function behindReferences(kind: EvidenceEntityKind, entity: EvidenceEntity): EvidenceReferenceFreshness[];
+type Counts = Record<'current' | 'behind' | 'unpinned', number>;
+export type EvidenceStatusResult = {
+    version: 1;
+    workspace_id: string;
+    /** Nodes and edges that carry evidence. */
+    entities: {
+        nodes: number;
+        edges: number;
+    };
+    /**
+     * Nodes and edges that carry none, counted in no freshness, so a reader
+     * tells a fully cited graph from a partly cited one (iss-423).
+     */
+    without_evidence: {
+        nodes: number;
+        edges: number;
+    };
+    by_freshness: Counts;
+    references: Counts;
+    /** Present only when the read names entities or asks for --behind. */
+    items?: EvidenceEntityStatus[];
+    not_found?: string[];
+};
+/** Claim freshness of every node and edge with evidence; the list only when asked for. */
+export declare function evidenceStatus(input: {
+    graph: PortableGraph;
+    workspace_id: string;
+    nodes?: string[];
+    edges?: string[];
+    behind_only?: boolean;
+}): EvidenceStatusResult;
+export {};
+//# sourceMappingURL=workspace-evidence-status.d.ts.map

package/dist/local/workspace-evidence-status.d.ts.map

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

package/dist/local/workspace-evidence-status.js

@@ -0,0 +1,141 @@
+import { evidenceClaimFreshness, hashGraphEdgeObjectSync, hashGraphNodeObjectSync, readEvidence } from '@software-dlc/graph/schema';
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+/**
+ * An entity's raw sync object hash, computed from its content: never the
+ * stored `data.object_hash`, which a projection file may hold stale.
+ */
+export function entityObjectHash(kind, entity) {
+    const domain = (entity.data?.data ?? {});
+    return kind === 'node'
+        ? hashGraphNodeObjectSync({
+            type: entity.type,
+            parent_id: typeof entity.parentId === 'string' ? entity.parentId : null,
+            domain
+        })
+        : hashGraphEdgeObjectSync({
+            source_id: String(entity.source),
+            target_id: String(entity.target),
+            domain
+        });
+}
+/** The entity's evidence on the current contract; legacy evidence is read as its upcast. */
+export function entityEvidence(entity) {
+    return readEvidence(entity.data?.meta);
+}
+/**
+ * Whether a reference counts toward its entity's freshness: one whose review
+ * status (its own, else its set's, as the Evidence Inspector reads it) is
+ * accepted, or that records none. A candidate, provisional, or superseded
+ * reference never puts its claim behind.
+ */
+function counts(reference, set) {
+    const status = reference.review_status ?? set.review_status;
+    return status === undefined || status === 'accepted';
+}
+/** behind when any counted reference is behind, else current when any is current, else unpinned. */
+export function entityFreshness(references) {
+    const counted = references.filter((reference) => reference.counted);
+    if (counted.some((reference) => reference.freshness === 'behind'))
+        return 'behind';
+    if (counted.some((reference) => reference.freshness === 'current'))
+        return 'current';
+    return 'unpinned';
+}
+/** One entity's claim freshness, or null when it carries no evidence. */
+export function entityEvidenceStatus(kind, entity) {
+    const evidence = entityEvidence(entity);
+    if (!evidence?.references.length)
+        return null;
+    const object_hash = entityObjectHash(kind, entity);
+    const references = evidence.references.map((reference) => ({
+        reference_id: reference.reference_id,
+        provider_key: reference.provider_key,
+        resource: reference.resource.id,
+        anchor: reference.anchor?.id ?? null,
+        review_status: reference.review_status ?? evidence.review_status ?? null,
+        claim_object_hash: reference.claim_object_hash ?? null,
+        freshness: evidenceClaimFreshness(reference, object_hash),
+        counted: counts(reference, evidence)
+    }));
+    const label = record(record(entity.data).data).label;
+    return {
+        kind,
+        id: entity.id,
+        type: kind === 'node' && typeof entity.type === 'string' ? entity.type : null,
+        label: typeof label === 'string' ? label : null,
+        object_hash,
+        freshness: entityFreshness(references),
+        references
+    };
+}
+/** The references that put an entity behind its claim. */
+export function behindReferences(kind, entity) {
+    return (entityEvidenceStatus(kind, entity)?.references.filter((reference) => reference.counted && reference.freshness === 'behind') ?? []);
+}
+function zero() {
+    return { current: 0, behind: 0, unpinned: 0 };
+}
+/** Claim freshness of every node and edge with evidence; the list only when asked for. */
+export function evidenceStatus(input) {
+    const statuses = [];
+    for (const node of input.graph.nodes) {
+        const status = entityEvidenceStatus('node', node);
+        if (status)
+            statuses.push(status);
+    }
+    for (const edge of input.graph.edges) {
+        const status = entityEvidenceStatus('edge', edge);
+        if (status)
+            statuses.push(status);
+    }
+    const by_freshness = zero();
+    const references = zero();
+    for (const status of statuses) {
+        if (status.freshness !== 'unknown')
+            by_freshness[status.freshness] += 1;
+        for (const reference of status.references) {
+            if (reference.freshness !== 'unknown')
+                references[reference.freshness] += 1;
+        }
+    }
+    const nodes = new Set(input.nodes ?? []);
+    const edges = new Set(input.edges ?? []);
+    const named = nodes.size + edges.size > 0;
+    const asked = named || Boolean(input.behind_only);
+    const present = (kind, id) => (kind === 'node' ? input.graph.nodes : input.graph.edges).some((entity) => entity.id === id);
+    const entities = {
+        nodes: statuses.filter((status) => status.kind === 'node').length,
+        edges: statuses.filter((status) => status.kind === 'edge').length
+    };
+    return {
+        version: 1,
+        workspace_id: input.workspace_id,
+        entities,
+        without_evidence: {
+            nodes: input.graph.nodes.length - entities.nodes,
+            edges: input.graph.edges.length - entities.edges
+        },
+        by_freshness,
+        references,
+        ...(asked
+            ? {
+                items: statuses.filter((status) => (!named ||
+                    (status.kind === 'node' ? nodes : edges).has(status.id)) &&
+                    (!input.behind_only || status.freshness === 'behind'))
+            }
+            : {}),
+        ...(named
+            ? {
+                not_found: [
+                    ...[...nodes].filter((id) => !present('node', id)),
+                    ...[...edges].filter((id) => !present('edge', id))
+                ].sort()
+            }
+            : {})
+    };
+}
+//# sourceMappingURL=workspace-evidence-status.js.map

package/dist/local/workspace-evidence-status.js.map

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