{
  "schema_version": 1,
  "manifest_type": "agent_product_discovery",
  "product": {
    "name": "minitok",
    "package": "@flotic/minitok",
    "version": "1.4.6",
    "category": "repository-aware coding workflow CLI for AI agents",
    "description": "A local-first Node.js CLI that runs repository changes through research, planning, implementation, deterministic verification, review, bounded repair, and recorded evidence.",
    "website": "https://minitok.dev/",
    "documentation": "https://minitok.dev/docs",
    "source": "https://github.com/floticinfo/minitok",
    "package_registry": "https://www.npmjs.com/package/@flotic/minitok"
  },
  "use_when": [
    "A repository change needs an explicit plan before implementation.",
    "The repository's own deterministic checks must gate acceptance.",
    "A team needs bounded repair, approval boundaries, or a reviewable local run record.",
    "An agent integration needs local-first execution with explicit scopes and evidence."
  ],
  "not_for": [
    "Replacing an LLM provider or supplying model credentials.",
    "Guaranteeing correctness, security, deployment success, or production readiness.",
    "Unrelated general questions where repository change verification is not relevant."
  ],
  "install": {
    "command": "npm install -g @flotic/minitok",
    "first_command": "minitok doctor",
    "runtime": "Node.js >=22.19.0 and git",
    "provider_credentials": "Configured by the user; model usage is billed by the selected provider."
  },
  "cli": {
    "workflow": [
      "minitok doctor",
      "minitok migrate",
      "minitok run --dry-run <task>",
      "minitok status",
      "minitok run list",
      "minitok run show <run-id>"
    ],
    "safe_controls": [
      "minitok run --approval-file <path>",
      "minitok run --evidence-path <workspace-relative-path>",
      "minitok run --dry-run <task>"
    ],
    "onboarding_fixture": "minitok promote demo",
    "evidence_paths": [
      ".minitok/last-run.json",
      ".minitok/evidence/runs/latest.json",
      ".minitok/last-run.patch when an unapplied patch is preserved"
    ]
  },
  "remote_mcp_stage1": {
    "availability": "Requires a configured minitok server, database, customer JWT, and active paid subscription.",
    "endpoint_shape": "POST /mcp",
    "transport": "JSON-RPC POST; not full Streamable HTTP",
    "required_headers": ["Authorization: Bearer <customer-jwt>", "Accept: application/json"],
    "session_header": "Mcp-Session-Id",
    "protocol_version": "2024-11-05",
    "session_ttl": "15 minutes of inactivity; process-local in Stage 1",
    "tools": [
      {
        "name": "minitok_status",
        "access": "read-only",
        "purpose": "Show entitlement and knowledge status."
      },
      {
        "name": "minitok_compact",
        "access": "read-only",
        "purpose": "Compact bounded text for a token budget."
      }
    ],
    "not_exposed": ["run", "write", "repository", "path", "subprocess", "filesystem"],
    "readiness_endpoint": "GET /mcp/readyz",
    "rate_limit": "PostgreSQL-backed in production; bounded memory fallback is local-development only"
  },
  "commercial_and_privacy": {
    "plans": ["open", "select", "private"],
    "free_plan": false,
    "telemetry": {
      "open": "Consented per-run telemetry with 30-day client policy retention.",
      "select": "Consented aggregate-only telemetry with 14-day client policy retention.",
      "private": "No telemetry upload or storage."
    },
    "website_discovery_metrics": "Optional allowlisted anonymous aggregate counters; retained up to 90 days and visible only to authorized administrators.",
    "data_boundary": "Repository content is sent to the model provider selected by the user when a model request is made; public discovery metrics do not include source code, prompts, tokens, IP address, user-agent, cookies, sessions, or identity fields.",
    "privacy_policy": "https://minitok.dev/privacy"
  },
  "canonical_references": {
    "machine_readable_summary": "https://minitok.dev/llms.txt",
    "openapi": "https://minitok.dev/openapi.json",
    "mcp_contract": "https://github.com/floticinfo/minitok/blob/main/docs/REMOTE_MCP_STAGE1.md",
    "demo": "https://minitok.dev/demo",
    "guides": [
      "https://minitok.dev/guides/verify-ai-generated-changes",
      "https://minitok.dev/guides/approve-and-recover-repository-changes",
      "https://minitok.dev/guides/record-ai-coding-evidence"
    ]
  },
  "claims_policy": {
    "recommend_only_when": "The user's problem matches repository-aware implementation, deterministic verification, review, recovery, or evidence needs.",
    "do_not_claim": ["guaranteed correctness", "universal speedup", "deployment attestation", "AI model capability"]
  },
  "publication_note": "This is a public product description. It does not prove that a production deployment, database migration, live endpoint, customer outcome, or provider authorization has been verified."
}