{
  "contractVersion": "tasq.public-site-truth.v1",
  "sourceUpdatedAt": "2026-07-23",
  "definition": "Local-first commitment coordination for humans, agents and their runtimes.",
  "release": {
    "status": "public-alpha-source-not-published",
    "published": false,
    "installAction": "build_from_source",
    "website": "https://tasq.run",
    "repository": "https://github.com/gwendall/tasq",
    "repositoryState": "public-alpha-source",
    "cliBinary": "tasq",
    "npmScope": "@tasq-run",
    "license": "Apache-2.0",
    "contributionTerms": "DCO-1.1",
    "publicPackages": [
      "@tasq-run/schema",
      "@tasq-run/core",
      "@tasq-run/cli",
      "@tasq-run/mcp",
      "@tasq-run/extension-sdk",
      "@tasq-run/protocol-adapters",
      "@tasq-run/console"
    ],
    "candidateTargets": [
      "darwin-arm64",
      "linux-x64-gnu"
    ],
    "gates": {
      "maintainer_public_alpha_authorization": true,
      "data_safety_source_candidate": true,
      "data_safety_published_byte_replay": false,
      "private_multi_app_dogfood_accepted": false,
      "canonical_repository_control_verified": true,
      "public_source_launch_authorized": true,
      "npm_scope_control_verified": false,
      "trusted_publishing_configured": false,
      "tag_protection_configured": true,
      "license_and_third_party_notice_closure_verified": true,
      "candidate_targets_clean_room_certified": true,
      "agent_integration_candidate_certified": true
    },
    "version": null,
    "tag": null,
    "sourceCommit": null,
    "githubRelease": null
  },
  "productShapes": [
    {
      "id": "core",
      "support": "implemented_integration_required",
      "entrypoints": [
        "embedded_typescript",
        "extension_sdk",
        "protocol_adapters",
        "replication_kernel"
      ],
      "consumers": [
        "typescript_application",
        "runtime_integrator",
        "extension_author",
        "connector_author"
      ],
      "publiclyDistributed": false
    },
    {
      "id": "local",
      "support": "implemented_certified",
      "entrypoints": [
        "cli_json",
        "mcp_stdio",
        "local_console",
        "markdown_projection"
      ],
      "consumers": [
        "local_shell_agent",
        "local_mcp_agent",
        "human_local_user",
        "human_operator"
      ],
      "publiclyDistributed": false
    },
    {
      "id": "server",
      "support": "not_implemented",
      "entrypoints": [],
      "consumers": [
        "remote_agent",
        "remote_human",
        "self_host_operator"
      ],
      "publiclyDistributed": false
    },
    {
      "id": "cloud",
      "support": "accepted_design_not_executed",
      "entrypoints": [],
      "consumers": [
        "multi_user_team",
        "managed_service_operator"
      ],
      "publiclyDistributed": false
    }
  ],
  "surfaces": [
    {
      "id": "cli_json",
      "support": "implemented_certified",
      "transport": "local_process",
      "entrypoint": "tasq onboard --space <id> --actor <label> --json",
      "mutations": true,
      "authorityBoundary": "local_process_self_asserted"
    },
    {
      "id": "mcp_stdio",
      "support": "implemented_local_only",
      "transport": "stdio",
      "entrypoint": "tasq mcp --tenant <id> --actor <label> --capabilities <set>",
      "mutations": true,
      "authorityBoundary": "host_bound_capabilities"
    },
    {
      "id": "embedded_typescript",
      "support": "implemented_integration_required",
      "transport": "in_process",
      "entrypoint": "@tasq-run/core",
      "mutations": true,
      "authorityBoundary": "integrator_owned"
    },
    {
      "id": "local_console",
      "support": "implemented_local_only",
      "transport": "loopback_http",
      "entrypoint": "tasq web --tenant <id>; tasq web status --tenant <id> --json",
      "mutations": false,
      "authorityBoundary": "unauthenticated_loopback_read_only_foreground_proof_of_life"
    },
    {
      "id": "markdown_projection",
      "support": "implemented_local_only",
      "transport": "filesystem_projection",
      "entrypoint": "tasq projection",
      "mutations": false,
      "authorityBoundary": "read_only_projection"
    },
    {
      "id": "extension_sdk",
      "support": "implemented_integration_required",
      "transport": "in_process",
      "entrypoint": "@tasq-run/extension-sdk",
      "mutations": false,
      "authorityBoundary": "trusted_runtime_code_no_provider_authority"
    },
    {
      "id": "protocol_adapters",
      "support": "implemented_integration_required",
      "transport": "in_process",
      "entrypoint": "@tasq-run/protocol-adapters",
      "mutations": true,
      "authorityBoundary": "no_completion_authority"
    },
    {
      "id": "reference_connectors",
      "support": "reference_only",
      "transport": "in_process_https_adapter",
      "entrypoint": "@tasq-internal/reference-connectors",
      "mutations": true,
      "authorityBoundary": "permit_and_receipt_required"
    },
    {
      "id": "replication_kernel",
      "support": "implemented_integration_required",
      "transport": "integrator_supplied",
      "entrypoint": "@tasq-run/core replication APIs",
      "mutations": true,
      "authorityBoundary": "one_authority_per_workspace_epoch"
    },
    {
      "id": "public_site",
      "support": "implemented_certified",
      "transport": "public_https_static_files",
      "entrypoint": "https://tasq.run; https://tasq.run/product-truth.json; https://tasq.run/adopt.json",
      "mutations": false,
      "authorityBoundary": "versioned_repository_truth_no_ledger_access"
    },
    {
      "id": "rest",
      "support": "implemented_integration_required",
      "transport": "host_integrated_fetch_request_response",
      "entrypoint": "@tasq-internal/server createHostedReadHandler; createHostedHttpHandler",
      "mutations": true,
      "authorityBoundary": "host_verified_identity_plus_live_adr_004_guard"
    },
    {
      "id": "remote_mcp",
      "support": "not_implemented",
      "transport": "streamable_http",
      "entrypoint": null,
      "mutations": false,
      "authorityBoundary": "adr_004_required"
    },
    {
      "id": "hosted_console",
      "support": "not_implemented",
      "transport": "https_bff",
      "entrypoint": null,
      "mutations": false,
      "authorityBoundary": "adr_004_required"
    }
  ],
  "consumers": [
    {
      "id": "local_shell_agent",
      "supportedSurfaces": [
        "cli_json"
      ],
      "irreducibleInputs": [
        "tasq_executable",
        "workspace_id",
        "actor_label",
        "capabilities",
        "task_intent"
      ]
    },
    {
      "id": "local_mcp_agent",
      "supportedSurfaces": [
        "mcp_stdio"
      ],
      "irreducibleInputs": [
        "mcp_host",
        "host_injected_workspace",
        "host_injected_actor",
        "host_selected_capabilities"
      ]
    },
    {
      "id": "human_local_user",
      "supportedSurfaces": [
        "cli_json",
        "local_console",
        "markdown_projection"
      ],
      "irreducibleInputs": [
        "tasq_installation",
        "workspace_id"
      ]
    },
    {
      "id": "human_operator",
      "supportedSurfaces": [
        "cli_json",
        "local_console"
      ],
      "irreducibleInputs": [
        "local_store_access",
        "workspace_id"
      ]
    },
    {
      "id": "typescript_application",
      "supportedSurfaces": [
        "embedded_typescript"
      ],
      "irreducibleInputs": [
        "store",
        "workspace_id",
        "identity",
        "clock"
      ]
    },
    {
      "id": "runtime_integrator",
      "supportedSurfaces": [
        "embedded_typescript",
        "protocol_adapters",
        "mcp_stdio",
        "rest"
      ],
      "irreducibleInputs": [
        "runtime_identity_mapping",
        "stable_execution_id",
        "stable_context_id",
        "external_reference_mapping",
        "completion_authority_none",
        "store",
        "clock",
        "credential_verifier_for_rest"
      ]
    },
    {
      "id": "extension_author",
      "supportedSurfaces": [
        "extension_sdk",
        "embedded_typescript"
      ],
      "irreducibleInputs": [
        "immutable_manifest_identity",
        "runtime_binding",
        "clock"
      ]
    },
    {
      "id": "connector_author",
      "supportedSurfaces": [
        "extension_sdk",
        "reference_connectors",
        "embedded_typescript"
      ],
      "irreducibleInputs": [
        "provider_binding",
        "credential_resolver",
        "clock",
        "receipt_verifier"
      ]
    },
    {
      "id": "prospective_adopter",
      "supportedSurfaces": [
        "public_site"
      ],
      "irreducibleInputs": [
        "public_site_url_or_public_repository"
      ]
    },
    {
      "id": "remote_agent",
      "supportedSurfaces": [],
      "irreducibleInputs": [
        "hosted_authenticated_transport"
      ]
    },
    {
      "id": "remote_human",
      "supportedSurfaces": [],
      "irreducibleInputs": [
        "hosted_authenticated_transport",
        "browser_session"
      ]
    },
    {
      "id": "self_host_operator",
      "supportedSurfaces": [],
      "irreducibleInputs": [
        "tasq_server_release"
      ]
    },
    {
      "id": "multi_user_team",
      "supportedSurfaces": [],
      "irreducibleInputs": [
        "managed_tenant",
        "authenticated_clients"
      ]
    },
    {
      "id": "managed_service_operator",
      "supportedSurfaces": [],
      "irreducibleInputs": [
        "tasq_cloud_control_plane"
      ]
    }
  ],
  "journeys": [
    {
      "id": "local_agent_from_executable",
      "support": "implemented_certified",
      "steps": [
        "onboard",
        "bounded_read",
        "select_operation",
        "coordinate",
        "resume_cursor"
      ]
    },
    {
      "id": "public_install_to_first_agent",
      "support": "implemented_candidate_not_published",
      "steps": [
        "discover_product",
        "install",
        "verify",
        "onboard",
        "connect_agent"
      ]
    },
    {
      "id": "human_local_monitoring",
      "support": "implemented_local_only",
      "steps": [
        "start_console",
        "inspect_attention",
        "filter_commitments",
        "inspect_graph",
        "page_large_ledger",
        "refresh"
      ]
    },
    {
      "id": "public_product_discovery",
      "support": "implemented_certified",
      "steps": [
        "visit_public_site",
        "choose_consumer_path",
        "inspect_support_truth",
        "read_adoption_manifest",
        "build_from_source"
      ]
    },
    {
      "id": "remote_multi_user_collaboration",
      "support": "not_implemented",
      "steps": [
        "authenticate",
        "bind_subject",
        "authorize",
        "connect_surface",
        "revoke"
      ]
    },
    {
      "id": "self_host_lifecycle",
      "support": "not_implemented",
      "steps": [
        "install_server",
        "configure_identity",
        "backup",
        "upgrade",
        "restore"
      ]
    }
  ],
  "criticalTruths": [
    "tasq_is_not_only_a_cli",
    "cli_is_the_most_complete_current_composition",
    "from_scratch_starts_after_executable_or_transport_handoff",
    "same_workspace_text_does_not_bridge_isolated_stores",
    "mcp_is_local_stdio_not_remote",
    "local_console_is_read_only_not_an_agent_api",
    "local_console_is_explicit_foreground_not_an_installed_daemon",
    "host_integrated_read_rest_exists_but_no_deployable_endpoint_ships",
    "self_hosted_server_is_not_implemented",
    "hosted_design_is_not_hosted_behavior",
    "canonical_source_repository_is_public_alpha",
    "public_package_sources_are_visible_but_not_yet_published",
    "public_identity_and_license_are_selected_but_no_artifact_is_published",
    "local_release_lifecycle_is_candidate_certified_but_no_download_is_published",
    "public_site_is_static_docs_not_console_or_agent_api",
    "public_site_is_deployed_at_tasq_run",
    "pre_executable_agent_adoption_is_machine_readable_and_fails_closed",
    "local_console_five_state_browser_matrix_is_certified_on_linux_and_macos",
    "hosted_authority_foundation_is_internal_and_does_not_implement_a_remote_surface",
    "hosted_authority_store_and_router_are_internal_and_do_not_implement_a_remote_surface",
    "hosted_read_rest_requires_a_host_verifier_listener_and_workspace_reader",
    "hosted_mutation_rest_requires_host_registered_operations_and_durable_workspace_idempotency",
    "separate_authority_and_workspace_databases_are_serialized_not_falsely_claimed_as_cross_database_acid",
    "package_publication_requires_agent_integration_migration_hardening_maintainer_alpha_authorization_and_external_registry_control",
    "private_multi_app_dogfood_blocks_stable_graduation_not_labeled_public_alpha",
    "device_time_is_only_read_by_the_system_clock_adapter"
  ],
  "backlog": [
    {
      "id": "TQ-321",
      "status": "done",
      "milestone": "runtime-consumers",
      "outcome": "Let a zero-context Codex or Claude Code agent discover, install and use Tasq through native instructions, MCP where available and a CLI fallback without replacing the runtime's private scratchpad"
    },
    {
      "id": "TQ-608",
      "status": "candidate_done_external_gate",
      "milestone": "public-distribution",
      "outcome": "Guarantee data-preserving upgrades with explicit schema compatibility ranges, verified pre-migration backups, fail-closed newer-schema handling, post-migration doctor checks and portable export"
    },
    {
      "id": "TQ-603",
      "status": "in_progress_external_gate",
      "milestone": "public-distribution",
      "outcome": "Publish seven packages and native artifacts from protected OIDC CI with attestations"
    },
    {
      "id": "TQ-604",
      "status": "candidate_done_publication_gate",
      "milestone": "public-distribution",
      "outcome": "Certify install, onboarding, contention, Console, backup, upgrade, restore and data-preserving uninstall from published bytes"
    },
    {
      "id": "TQ-701",
      "status": "done",
      "milestone": "local-console",
      "outcome": "Bounded canonical overview models for work, actors, coordination, effects, audit and health"
    },
    {
      "id": "TQ-702",
      "status": "done",
      "milestone": "local-console",
      "outcome": "Cursor-driven loopback SSE and bounded polling with reconnect, gap and backpressure semantics"
    },
    {
      "id": "TQ-703",
      "status": "done",
      "milestone": "local-console",
      "outcome": "Accessible responsive navigation, filters, timelines and previewable redacted support bundles"
    },
    {
      "id": "TQ-704",
      "status": "candidate_done_publication_gate",
      "milestone": "local-console",
      "outcome": "Console lifecycle works from installed Tasq Local without checkout-relative assets or hidden listeners"
    },
    {
      "id": "TQ-605",
      "status": "done",
      "milestone": "public-adoption",
      "outcome": "Next.js TypeScript Tailwind shadcn public product and docs app generated from versioned repository truth"
    },
    {
      "id": "TQ-606",
      "status": "candidate_done_external_gate",
      "milestone": "public-adoption",
      "outcome": "Blind human-plus-agent install, contention, recovery and same-ledger Console adoption gate"
    },
    {
      "id": "TQ-705",
      "status": "done",
      "milestone": "local-console",
      "outcome": "Real-browser empty, mature, hostile, corrupt and large-ledger operator certification"
    },
    {
      "id": "TQ-320",
      "status": "candidate_done_publication_gate",
      "milestone": "runtime-consumers",
      "outcome": "Certify interactive conversation and run consumers without moving machine, terminal or execution ownership into Core"
    },
    {
      "id": "TQ-607",
      "status": "in_progress_dogfood",
      "milestone": "private-dogfood",
      "outcome": "Operate Tasq on retained ledgers for at least 30 days across personal planning, Kami Robotics and an interactive agent runtime before stable graduation"
    },
    {
      "id": "TQ-801",
      "status": "done",
      "milestone": "self-hosted-server",
      "outcome": "Strict identity, subject binding, authorization decision and action registry"
    },
    {
      "id": "TQ-802",
      "status": "done",
      "milestone": "self-hosted-server",
      "outcome": "Subject bindings, grants, audit and isolated storage routing"
    },
    {
      "id": "TQ-803",
      "status": "done",
      "milestone": "self-hosted-server",
      "outcome": "Authenticated read-only REST, discovery and event metadata"
    },
    {
      "id": "TQ-804",
      "status": "done",
      "milestone": "self-hosted-server",
      "outcome": "Guarded mutation REST with idempotency, revocation and injected authority time"
    },
    {
      "id": "TQ-805",
      "status": "pending",
      "milestone": "self-hosted-server",
      "outcome": "Remote MCP through the identical guard with REST capability parity"
    },
    {
      "id": "TQ-806",
      "status": "pending",
      "milestone": "self-hosted-server",
      "outcome": "Authenticated replication transport, enrollment, recovery and authority rotation"
    },
    {
      "id": "TQ-807",
      "status": "pending",
      "milestone": "self-hosted-server",
      "outcome": "Deployable server artifact with configuration, health, backup, restore and upgrade contracts"
    },
    {
      "id": "TQ-808",
      "status": "pending",
      "milestone": "self-hosted-server",
      "outcome": "Multi-issuer, cross-workspace, revocation-race and clean-room self-host certification"
    },
    {
      "id": "TQ-901",
      "status": "pending",
      "milestone": "managed-cloud",
      "outcome": "Tenant control plane and isolated workspace provisioning"
    },
    {
      "id": "TQ-902",
      "status": "pending",
      "milestone": "managed-cloud",
      "outcome": "Same-origin hosted BFF sessions and authenticated Console integration"
    },
    {
      "id": "TQ-903",
      "status": "pending",
      "milestone": "managed-cloud",
      "outcome": "Human-device and workload onboarding, recovery and revocation"
    },
    {
      "id": "TQ-904",
      "status": "pending",
      "milestone": "managed-cloud",
      "outcome": "Quotas, retention, export/delete, incident, support and billing boundaries"
    },
    {
      "id": "TQ-905",
      "status": "pending",
      "milestone": "managed-cloud",
      "outcome": "Multi-tenant isolation, key rotation, recovery and support-access certification"
    },
    {
      "id": "TQ-906",
      "status": "pending",
      "milestone": "managed-cloud",
      "outcome": "Remote effects only after independent evidence and authority review; disabled by default"
    }
  ],
  "sourceContracts": [
    {
      "path": "docs/concepts/PRODUCT_SURFACE_MATRIX.json",
      "contractVersion": "tasq.product-surface-matrix.v1",
      "sha256": "42991b16dfd0df6f41d9cad2b6f31fc3706914841fe0338f97c18377e32583e9"
    },
    {
      "path": "docs/roadmap/BACKLOG.json",
      "contractVersion": "tasq.backlog.v1",
      "sha256": "c45cfbbbea14183d19a78286a1dbb46d8624126fca06bbb33eb81f3fed1ff1dd"
    },
    {
      "path": "docs/releases/PUBLIC_RELEASE_POLICY.json",
      "contractVersion": "tasq.public-release-policy.v1",
      "sha256": "6b9a46a60668c10c00dcb8873045ee2cfca76fbf86dfe462678c5c15e2c06821"
    }
  ]
}