project-tiny-context-harness 0.8.17 → 0.12.0

package/dist/lib/design-resource-handoff-shape.js

@@ -1,180 +0,0 @@
-import { parseDesignResourceSymbolicHandoffShape } from "./design-resource-symbolic-fact-shape.js";
-import { parseDesignResourceTechnicalFeasibilityInputs } from "./design-resource-implementation-feasibility-shape.js";
-import { parseDesignResourceAssetBindings, parseDesignResourceAxisDispositions, parseDesignResourceConditionExclusions, parseDesignResourceEnvironments, parseDesignResourceFactCells, parseDesignResourceLineageNodes, parseDesignResourceOracles, parseDesignResourceProofObligations, parseDesignResourceProperties, parseDesignResourceVariationAxisDispositions, parseDesignResourceVariationExclusions, parseDesignResourceVariations, } from "./design-resource-fact-manifest-shape.js";
-import { parseDesignResourceHandoffBlockers, parseDesignResourceHandoffCoverage, parseDesignResourceHandoffEvidence, parseDesignResourceHandoffFacts, parseDesignResourceHandoffResourceFactClosure, } from "./design-resource-handoff-shape-evidence.js";
-import { contractKey, stableKeys, } from "./design-resource-handoff-shape-primitives.js";
-import { parseDesignResourceHandoffConditions, parseDesignResourceHandoffResources, parseDesignResourceHandoffSubjects, parseDesignResourceHandoffTargets, } from "./design-resource-handoff-shape-structure.js";
-import { literal, object, repositoryFile, string, strings, } from "./long-task-shape-primitives.js";
-export function parseDesignResourceHandoffInputShape(value) {
-    if (value &&
-        typeof value === "object" &&
-        !Array.isArray(value) &&
-        value.representation === "manifest_backed")
-        return parseManifestBackedDesignResourceHandoffShape(value);
-    return parseDesignResourceHandoffShape(value);
-}
-export function parseAnyDesignResourceHandoffInputShape(value) {
-    if (value &&
-        typeof value === "object" &&
-        !Array.isArray(value) &&
-        value.schema_version ===
-            "design-resource-handoff-v2")
-        return parseDesignResourceSymbolicHandoffShape(value);
-    return parseDesignResourceHandoffInputShape(value);
-}
-export function parseDesignResourceHandoffShape(value) {
-    const root = object(value, "design_resource_handoff", [
-        "schema_version",
-        "intent",
-        "scope",
-        "provenance",
-        "resources",
-        "axis_dispositions",
-        "condition_exclusions",
-        "conditions",
-        "subjects",
-        "variation_axis_dispositions",
-        "variation_exclusions",
-        "variations",
-        "properties",
-        "lineage_nodes",
-        "targets",
-        "evidence",
-        "fact_cells",
-        "facts",
-        "proof_obligations",
-        "oracles",
-        "environments",
-        "asset_bindings",
-        "resource_fact_closure",
-        "coverage",
-        "acceptance_blockers",
-        "proposal",
-    ], ["technical_feasibility_inputs"]);
-    const scope = object(root.scope, "design_resource_handoff.scope", [
-        "key",
-        "style_dependency",
-        "surface_keys",
-        "necessary_context",
-        "exclusions",
-    ]);
-    const provenance = object(root.provenance, "design_resource_handoff.provenance", [
-        "provider",
-        "provider_version",
-        "project",
-        "run",
-        "capability",
-        "agent",
-        "model",
-        "design_system_id",
-    ]);
-    const proposal = object(root.proposal, "design_resource_handoff.proposal", [
-        "reconciliation_status",
-        "path",
-        "revision",
-    ]);
-    return {
-        schema_version: literal(root.schema_version, ["design-resource-handoff-v1"], "design_resource_handoff.schema_version"),
-        intent: literal(root.intent, ["implementation_handoff"], "design_resource_handoff.intent"),
-        scope: {
-            key: contractKey(scope.key, "design_resource_handoff.scope.key"),
-            style_dependency: literal(scope.style_dependency, ["style-bearing", "non-fidelity", "mixed"], "design_resource_handoff.scope.style_dependency"),
-            surface_keys: stableKeys(scope.surface_keys, "design_resource_handoff.scope.surface_keys"),
-            necessary_context: strings(scope.necessary_context, "design_resource_handoff.scope.necessary_context"),
-            exclusions: strings(scope.exclusions, "design_resource_handoff.scope.exclusions"),
-        },
-        provenance: {
-            provider: string(provenance.provider, "design_resource_handoff.provenance.provider"),
-            provider_version: string(provenance.provider_version, "design_resource_handoff.provenance.provider_version"),
-            project: string(provenance.project, "design_resource_handoff.provenance.project"),
-            run: string(provenance.run, "design_resource_handoff.provenance.run"),
-            capability: string(provenance.capability, "design_resource_handoff.provenance.capability"),
-            agent: string(provenance.agent, "design_resource_handoff.provenance.agent"),
-            model: string(provenance.model, "design_resource_handoff.provenance.model"),
-            design_system_id: string(provenance.design_system_id, "design_resource_handoff.provenance.design_system_id"),
-        },
-        technical_feasibility_inputs: parseDesignResourceTechnicalFeasibilityInputs(root.technical_feasibility_inputs ?? []),
-        resources: parseDesignResourceHandoffResources(root.resources),
-        axis_dispositions: parseDesignResourceAxisDispositions(root.axis_dispositions),
-        condition_exclusions: parseDesignResourceConditionExclusions(root.condition_exclusions),
-        conditions: parseDesignResourceHandoffConditions(root.conditions),
-        subjects: parseDesignResourceHandoffSubjects(root.subjects),
-        variation_axis_dispositions: parseDesignResourceVariationAxisDispositions(root.variation_axis_dispositions),
-        variation_exclusions: parseDesignResourceVariationExclusions(root.variation_exclusions),
-        variations: parseDesignResourceVariations(root.variations),
-        properties: parseDesignResourceProperties(root.properties),
-        lineage_nodes: parseDesignResourceLineageNodes(root.lineage_nodes),
-        targets: parseDesignResourceHandoffTargets(root.targets),
-        evidence: parseDesignResourceHandoffEvidence(root.evidence),
-        fact_cells: parseDesignResourceFactCells(root.fact_cells),
-        facts: parseDesignResourceHandoffFacts(root.facts),
-        proof_obligations: parseDesignResourceProofObligations(root.proof_obligations),
-        oracles: parseDesignResourceOracles(root.oracles),
-        environments: parseDesignResourceEnvironments(root.environments),
-        asset_bindings: parseDesignResourceAssetBindings(root.asset_bindings),
-        resource_fact_closure: parseDesignResourceHandoffResourceFactClosure(root.resource_fact_closure),
-        coverage: parseDesignResourceHandoffCoverage(root.coverage),
-        acceptance_blockers: parseDesignResourceHandoffBlockers(root.acceptance_blockers),
-        proposal: {
-            reconciliation_status: literal(proposal.reconciliation_status, ["applied", "returned", "not_applicable"], "design_resource_handoff.proposal.reconciliation_status"),
-            path: repositoryFile(proposal.path, "design_resource_handoff.proposal.path"),
-            revision: string(proposal.revision, "design_resource_handoff.proposal.revision"),
-        },
-    };
-}
-function parseManifestBackedDesignResourceHandoffShape(value) {
-    const root = object(value, "design_resource_handoff", [
-        "schema_version",
-        "representation",
-        "intent",
-        "scope",
-        "provenance",
-        "resources",
-        "targets",
-        "resource_fact_closure",
-        "coverage",
-        "proposal",
-    ], ["technical_feasibility_inputs"]);
-    const parsed = parseDesignResourceHandoffShape({
-        schema_version: root.schema_version,
-        intent: root.intent,
-        scope: root.scope,
-        provenance: root.provenance,
-        technical_feasibility_inputs: root.technical_feasibility_inputs ?? [],
-        resources: root.resources,
-        axis_dispositions: [],
-        condition_exclusions: [],
-        conditions: [],
-        subjects: [],
-        variation_axis_dispositions: [],
-        variation_exclusions: [],
-        variations: [],
-        properties: [],
-        lineage_nodes: [],
-        targets: root.targets,
-        evidence: [],
-        fact_cells: [],
-        facts: [],
-        proof_obligations: [],
-        oracles: [],
-        environments: [],
-        asset_bindings: [],
-        resource_fact_closure: root.resource_fact_closure,
-        coverage: root.coverage,
-        acceptance_blockers: [],
-        proposal: root.proposal,
-    });
-    return {
-        schema_version: parsed.schema_version,
-        representation: literal(root.representation, ["manifest_backed"], "design_resource_handoff.representation"),
-        intent: parsed.intent,
-        scope: parsed.scope,
-        provenance: parsed.provenance,
-        technical_feasibility_inputs: parsed.technical_feasibility_inputs,
-        resources: parsed.resources,
-        targets: parsed.targets,
-        resource_fact_closure: parsed.resource_fact_closure,
-        coverage: parsed.coverage,
-        proposal: parsed.proposal,
-    };
-}

package/dist/lib/design-resource-handoff-snapshot.d.ts

@@ -1,6 +0,0 @@
-import type { ParsedDesignResourceHandoffInputV1 } from "./design-resource-handoff-input-types.js";
-export interface DesignResourceSnapshot {
-    contents: Map<string, Buffer>;
-    hashes: Record<string, string>;
-}
-export declare function readDesignResourceSnapshot(repository: string, parsed: ParsedDesignResourceHandoffInputV1): Promise<DesignResourceSnapshot>;

package/dist/lib/design-resource-handoff-snapshot.js

@@ -1,25 +0,0 @@
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import { invalidDesignResourceHandoff } from "./design-resource-handoff-validation-primitives.js";
-import { assertProtectedRepositoryFile } from "./long-task-protected-files.js";
-import { sha256Hex } from "./strict-codec.js";
-import { assertDesignResourceV1ManifestCapacity } from "./design-resource-v1-capacity.js";
-export async function readDesignResourceSnapshot(repository, parsed) {
-    const contents = new Map();
-    const hashes = {};
-    const manifestResourceRefs = new Set(parsed.handoff.targets.map((target) => target.source_profile.fact_manifest_resource_ref));
-    for (const resource of parsed.handoff.resources) {
-        if (resource.path === parsed.handoff_path)
-            invalidDesignResourceHandoff("resource_must_not_be_handoff", resource.key);
-        const file = await assertProtectedRepositoryFile(repository, path.resolve(repository, ...resource.path.split("/")), `design_resource:${resource.key}`);
-        if (manifestResourceRefs.has(resource.key))
-            await assertDesignResourceV1ManifestCapacity(file);
-        const bytes = await readFile(file);
-        const digest = sha256Hex(bytes);
-        if (digest !== resource.sha256)
-            invalidDesignResourceHandoff("resource_digest_mismatch", `${resource.key}:${resource.sha256}:${digest}`);
-        contents.set(resource.key, bytes);
-        hashes[resource.key] = digest;
-    }
-    return { contents, hashes };
-}

package/dist/lib/design-resource-handoff-types.d.ts

@@ -1,261 +0,0 @@
-import type { ExecutionTargetCapabilityV2 } from "./execution-target-capabilities.js";
-import type { DesignResourceAssetBindingV1, DesignResourceAxisDispositionV1, DesignResourceConditionCombinationDispositionV1, DesignResourceEnvironmentV1, DesignResourceFactCellV1, DesignResourceFactV1, DesignResourceLineageNodeV1, DesignResourceManifestCollectionName, DesignResourceOracleV1, DesignResourcePropertyDefinitionV1, DesignResourceProofObligationV1, DesignResourceRelationEndpointV1, DesignResourceSubjectKind, DesignResourceSubjectPresenceKind, DesignResourceSubjectVariationV1, DesignResourceVariationAxisDispositionV1, DesignResourceVariationCombinationDispositionV1 } from "./design-resource-fact-manifest-types.js";
-import type { DesignResourceImplementationFeasibilityIdentityV1, DesignResourceImplementationFeasibilityV1, DesignResourceTechnicalFeasibilityInputV1 } from "./design-resource-implementation-feasibility-types.js";
-export declare const DESIGN_RESOURCE_DIMENSIONS: readonly ["surface_flow", "visual_content", "component_control", "state_interaction", "motion", "adaptation_input", "accessibility", "assets"];
-export type DesignResourceDimension = (typeof DESIGN_RESOURCE_DIMENSIONS)[number];
-export declare const DESIGN_RESOURCE_EVIDENCE_KINDS: readonly ["frame", "component_variant", "prototype_state", "prototype_transition", "motion_spec", "motion_capture", "responsive_spec", "input_spec", "accessibility_spec", "semantic_tree", "token_spec", "asset", "annotation", "localization_spec", "system_ui_spec", "haptic_spec", "sound_spec", "sound_capture", "render_environment", "relation_spec"];
-export type DesignResourceEvidenceKind = (typeof DESIGN_RESOURCE_EVIDENCE_KINDS)[number];
-export declare const DESIGN_RESOURCE_VERIFICATION_METHODS: readonly ["layout_geometry", "visual_pixel", "design_token", "content", "component_state", "interaction_trace", "motion_timeline", "responsive_reflow", "input_method", "accessibility_semantics", "accessibility_navigation", "accessibility_visual", "gesture_trace", "scroll_navigation", "localization", "system_ui", "haptic_feedback", "sound_feedback", "asset_integrity"];
-export type DesignResourceVerificationMethod = (typeof DESIGN_RESOURCE_VERIFICATION_METHODS)[number];
-export declare const DESIGN_RESOURCE_LOCATOR_KINDS: readonly ["html_selector", "html_inner_html", "markdown_anchor", "json_pointer", "css_selector", "css_custom_property", "html_attribute", "css_declaration", "javascript_export", "svg_selector", "svg_inner_xml", "svg_attribute", "whole_resource"];
-export type DesignResourceLocatorKind = (typeof DESIGN_RESOURCE_LOCATOR_KINDS)[number];
-export type DesignResourceSourceProfileKind = "implementation_web" | "implementation_app" | "reference";
-export type DesignResourceCoverageDisposition = "covered" | "not_applicable" | "excluded_by_scope" | "decision_required" | "unavailable";
-export interface DesignResourceHandoffV1 {
-    schema_version: "design-resource-handoff-v1";
-    intent: "implementation_handoff";
-    scope: {
-        key: string;
-        style_dependency: "style-bearing" | "non-fidelity" | "mixed";
-        surface_keys: string[];
-        necessary_context: string[];
-        exclusions: string[];
-    };
-    provenance: {
-        provider: string;
-        provider_version: string;
-        project: string;
-        run: string;
-        capability: string;
-        agent: string;
-        model: string;
-        design_system_id: string;
-    };
-    technical_feasibility_inputs: DesignResourceTechnicalFeasibilityInputV1[];
-    resources: DesignResourceHandoffResourceV1[];
-    axis_dispositions: DesignResourceAxisDispositionV1[];
-    condition_exclusions: DesignResourceConditionCombinationDispositionV1[];
-    conditions: DesignResourceHandoffConditionV1[];
-    subjects: DesignResourceHandoffSubjectV1[];
-    variation_axis_dispositions: DesignResourceVariationAxisDispositionV1[];
-    variation_exclusions: DesignResourceVariationCombinationDispositionV1[];
-    variations: DesignResourceSubjectVariationV1[];
-    properties: DesignResourcePropertyDefinitionV1[];
-    lineage_nodes: DesignResourceLineageNodeV1[];
-    targets: DesignResourceHandoffTargetV1[];
-    evidence: DesignResourceHandoffEvidenceV1[];
-    fact_cells: DesignResourceFactCellV1[];
-    facts: DesignResourceFactV1[];
-    proof_obligations: DesignResourceProofObligationV1[];
-    oracles: DesignResourceOracleV1[];
-    environments: DesignResourceEnvironmentV1[];
-    asset_bindings: DesignResourceAssetBindingV1[];
-    resource_fact_closure: DesignResourceHandoffResourceFactClosureV1[];
-    coverage: DesignResourceHandoffCoverageV1[];
-    acceptance_blockers: DesignResourceHandoffBlockerV1[];
-    proposal: {
-        reconciliation_status: "applied" | "returned" | "not_applicable";
-        path: string;
-        revision: string;
-    };
-}
-export interface DesignResourceHandoffResourceV1 {
-    key: string;
-    role: "exact_target" | "constraint" | "supporting";
-    path: string;
-    media_type: string;
-    sha256: string;
-    editable_upstream: {
-        owner: string;
-        locator: string;
-        update_route: string;
-    };
-}
-export interface DesignResourceHandoffConditionV1 {
-    key: string;
-    platform: string;
-    os_version: string;
-    device_profile: string;
-    form_factor: string;
-    viewport: {
-        key: string;
-        width: number;
-        height: number;
-        unit: "px";
-    };
-    orientation: string;
-    density: {
-        key: string;
-        pixel_ratio: number;
-    };
-    safe_area: {
-        key: string;
-        top: number;
-        right: number;
-        bottom: number;
-        left: number;
-        unit: "px";
-    };
-    window_state: string;
-    fold_state: string;
-    display_mode: string;
-    color_scheme: string;
-    locale: string;
-    language: string;
-    script: string;
-    direction: "ltr" | "rtl" | "not_applicable";
-    pseudo_localization: string;
-    content_case: string;
-    data_case: string;
-    text_scale: {
-        key: string;
-        multiplier: number;
-    };
-    input_method: string;
-    assistive_technology: string;
-    motion: string;
-    transparency: string;
-    contrast: string;
-    bold_text: string;
-    button_shapes: string;
-    system_ui: string;
-    ime: string;
-    permission: string;
-    capability: string;
-    connectivity: string;
-    lifecycle: string;
-    custom_axes: Array<{
-        axis_ref: string;
-        value_ref: string;
-    }>;
-}
-export interface DesignResourceHandoffSubjectV1 {
-    key: string;
-    kind: DesignResourceSubjectKind;
-    stable_keys: string[];
-    target_refs: string[];
-    parent_ref: string | null;
-    instance_of_ref: string | null;
-    slot_key: string | null;
-    override_of_ref: string | null;
-    family_ref: string | null;
-    presence: DesignResourceSubjectPresenceKind;
-    presence_rule_ref: string | null;
-    population_ref: string | null;
-    portal_host_ref: string | null;
-    relation_endpoints: DesignResourceRelationEndpointV1[];
-    census_refs: string[];
-}
-export interface DesignResourceHandoffTargetV1 {
-    key: string;
-    interpretation: "exact_target" | "constraint";
-    resource_refs: string[];
-    condition_refs: string[];
-    source_profile: {
-        kind: DesignResourceSourceProfileKind;
-        entry_resource_ref: string;
-        dependency_resource_refs: string[];
-        fact_manifest_resource_ref: string;
-        acquisition: "complete";
-    };
-    selection_basis: string;
-}
-export interface DesignResourceHandoffEvidenceV1 {
-    key: string;
-    resource_ref: string;
-    kind: DesignResourceEvidenceKind;
-    locator: {
-        kind: DesignResourceLocatorKind;
-        value: string;
-    };
-    condition_refs: string[];
-}
-export type DesignResourceHandoffFactV1 = DesignResourceFactV1;
-export interface DesignResourceHandoffResourceFactClosureV1 {
-    key: string;
-    resource_ref: string;
-    disposition: "material_with_facts" | "supporting_only";
-    fact_refs: string[];
-    inspection: {
-        status: "complete";
-        inspector: string;
-    };
-    rationale: string;
-}
-export interface DesignResourceHandoffCoverageV1 {
-    key: string;
-    subject_refs: string[];
-    dimension: DesignResourceDimension;
-    disposition: DesignResourceCoverageDisposition;
-    target_refs: string[];
-    condition_refs: string[];
-    variation_refs: string[];
-    property_refs: string[];
-    evidence_refs: string[];
-    fact_cell_refs: string[];
-    fact_refs: string[];
-    proof_obligation_refs: string[];
-    source_item_refs: string[];
-    verification_methods: DesignResourceVerificationMethod[];
-    rationale: string;
-}
-export interface DesignResourceHandoffBlockerV1 {
-    key: string;
-    target_refs: string[];
-    subject_refs: string[];
-    dimensions: DesignResourceDimension[];
-    fact_cell_refs: string[];
-    fact_refs: string[];
-    proof_obligation_refs: string[];
-    source_item_refs: string[];
-    verification_methods: DesignResourceVerificationMethod[];
-    required_capabilities: ExecutionTargetCapabilityV2[];
-    description: string;
-}
-export interface ParsedDesignResourceHandoffV1 {
-    handoff_path: string;
-    handoff: DesignResourceHandoffV1;
-    source_item_keys: string[];
-    source_item_kinds: Record<string, string>;
-}
-export interface DesignResourceHandoffPreflightV1 extends ParsedDesignResourceHandoffV1 {
-    schema_version: "design-resource-handoff-preflight-v1";
-    status: "ready";
-    resource_hashes: Record<string, string>;
-    technical_feasibility_documents: DesignResourceImplementationFeasibilityV1[];
-    technical_feasibility_identities: DesignResourceImplementationFeasibilityIdentityV1[];
-    limitations: string[];
-    manifest_identities: Array<{
-        resource_ref: string;
-        path: string;
-        sha256: string;
-        scope_key: string;
-        target_key: string;
-        collections: Array<{
-            name: DesignResourceManifestCollectionName;
-            expected_count: number;
-            identity_sha256: string;
-        }>;
-    }>;
-    counts: {
-        resources: number;
-        manifests: number;
-        axis_dispositions: number;
-        conditions: number;
-        subjects: number;
-        variations: number;
-        properties: number;
-        lineage_nodes: number;
-        targets: number;
-        evidence: number;
-        fact_cells: number;
-        facts: number;
-        proof_obligations: number;
-        oracles: number;
-        environments: number;
-        asset_bindings: number;
-        resource_fact_closure: number;
-        coverage: number;
-        acceptance_blockers: number;
-    };
-}

package/dist/lib/design-resource-handoff-types.js

@@ -1,68 +0,0 @@
-export const DESIGN_RESOURCE_DIMENSIONS = [
-    "surface_flow",
-    "visual_content",
-    "component_control",
-    "state_interaction",
-    "motion",
-    "adaptation_input",
-    "accessibility",
-    "assets",
-];
-export const DESIGN_RESOURCE_EVIDENCE_KINDS = [
-    "frame",
-    "component_variant",
-    "prototype_state",
-    "prototype_transition",
-    "motion_spec",
-    "motion_capture",
-    "responsive_spec",
-    "input_spec",
-    "accessibility_spec",
-    "semantic_tree",
-    "token_spec",
-    "asset",
-    "annotation",
-    "localization_spec",
-    "system_ui_spec",
-    "haptic_spec",
-    "sound_spec",
-    "sound_capture",
-    "render_environment",
-    "relation_spec",
-];
-export const DESIGN_RESOURCE_VERIFICATION_METHODS = [
-    "layout_geometry",
-    "visual_pixel",
-    "design_token",
-    "content",
-    "component_state",
-    "interaction_trace",
-    "motion_timeline",
-    "responsive_reflow",
-    "input_method",
-    "accessibility_semantics",
-    "accessibility_navigation",
-    "accessibility_visual",
-    "gesture_trace",
-    "scroll_navigation",
-    "localization",
-    "system_ui",
-    "haptic_feedback",
-    "sound_feedback",
-    "asset_integrity",
-];
-export const DESIGN_RESOURCE_LOCATOR_KINDS = [
-    "html_selector",
-    "html_inner_html",
-    "markdown_anchor",
-    "json_pointer",
-    "css_selector",
-    "css_custom_property",
-    "html_attribute",
-    "css_declaration",
-    "javascript_export",
-    "svg_selector",
-    "svg_inner_xml",
-    "svg_attribute",
-    "whole_resource",
-];

package/dist/lib/design-resource-handoff-validation-coverage.d.ts

@@ -1,4 +0,0 @@
-import type { DesignResourceHandoffV1 } from "./design-resource-handoff-types.js";
-export declare function validateDesignResourceCoverage(handoff: DesignResourceHandoffV1, subjects: Map<string, unknown>, targets: Map<string, DesignResourceHandoffV1["targets"][number]>, conditions: Map<string, unknown>, evidence: Map<string, DesignResourceHandoffV1["evidence"][number]>, facts: Map<string, DesignResourceHandoffV1["facts"][number]>, sourceItems: Map<string, string>): void;
-export declare function validateDesignResourceBlockers(handoff: DesignResourceHandoffV1, subjects: Map<string, unknown>, targets: Map<string, unknown>, sourceItems: Map<string, string>): void;
-export declare function validateDesignResourceReachability(handoff: DesignResourceHandoffV1): void;