@vegastack/vegafactory 0.19.0

package/skill/dev-setup/refresh/sources.json

@@ -0,0 +1,602 @@
+{
+  "schemaVersion": 1,
+  "retrievalBaseline": "2026-08-27",
+  "policy": {
+    "criticalTopics": [
+      "claude-code-memory",
+      "codex-agents-md"
+    ],
+    "defaultChecksumScope": "html-text-v1",
+    "offline": "Use cached metadata only; fail closed when a critical entry is missing or older than thresholdDays.",
+    "drift": "Any drift requires reading the changed page and a human-reviewed PR updating references/harness-facts.md; never auto-apply.",
+    "copyright": "Store claim metadata, URLs, hashes, and concise excerpts only; never archive third-party documentation corpora.",
+    "cadence": "weekly scheduled-agent refresh; thresholdDays must be >= 14 (2x cadence) so a single missed run never breaches a threshold"
+  },
+  "sources": [
+    {
+      "id": "CC-MEMORY",
+      "service": "Claude Code memory files and imports (CLAUDE.md, AGENTS.md, @imports)",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": true,
+      "urls": {
+        "primary": "https://code.claude.com/docs/en/memory.md"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "claude-code-memory"
+      ],
+      "affected": [
+        "references/harness-facts.md",
+        "SKILL.md"
+      ],
+      "checksum": "2c23688672796b989538e10431acb8db803776c03c54a8a3a6fe13e47fab3fe5",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "CC-SKILLS",
+      "service": "Claude Code skill discovery locations and frontmatter",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://code.claude.com/docs/en/skills.md"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "claude-code-skills"
+      ],
+      "affected": [
+        "references/harness-facts.md"
+      ],
+      "checksum": "38487567830df7ae08021b7b74573fa70d235e40462debc44911a99c77bc3604",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "CC-TOOLS",
+      "service": "Claude Code AskUserQuestion tool behavior",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://code.claude.com/docs/en/tools-reference.md"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "claude-code-tools"
+      ],
+      "affected": [
+        "references/harness-facts.md",
+        "SKILL.md"
+      ],
+      "checksum": "f90f7f9f3966740b1d9d33bdfd065470e933c52d8ef1d4ee079f55006433b775",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "CODEX-AGENTS",
+      "service": "Codex AGENTS.md discovery, merging, and size cap",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": true,
+      "urls": {
+        "primary": "https://learn.chatgpt.com/docs/agent-configuration/agents-md.md"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "codex-agents-md"
+      ],
+      "affected": [
+        "references/harness-facts.md"
+      ],
+      "checksum": "9eacb3d812b87be4acc1213af58ded35e8f387bcf1589c203bbb452ead0c4774",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "CODEX-SKILLS",
+      "service": "Codex skills discovery, frontmatter, and request_user_input gating",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://learn.chatgpt.com/docs/build-skills.md"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "codex-skills"
+      ],
+      "affected": [
+        "references/harness-facts.md",
+        "SKILL.md"
+      ],
+      "checksum": "44aa6d490f4567c0b1fb064deab642bfac590f0e721228e0c53fe738db191026",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "CC-HOOKS",
+      "service": "Claude Code hooks (Stop event, settings.json wiring, block/reason contract)",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://code.claude.com/docs/en/hooks.md"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "claude-code-hooks"
+      ],
+      "affected": [
+        "references/harness-facts.md",
+        "SKILL.md"
+      ],
+      "checksum": "bd1c792fd89373ffd403193a6a108e7f3c19319ae4afdc70f411f854905fbf3b",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "CODEX-HOOKS",
+      "service": "Codex hooks (hooks.json locations, trust gating, Stop event contract)",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://learn.chatgpt.com/docs/hooks.md"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "codex-hooks"
+      ],
+      "affected": [
+        "references/harness-facts.md",
+        "SKILL.md"
+      ],
+      "checksum": "3bf9362173613a652a038fb74424b22c48fc1b698f76282ba75d25bb8bc0abaa",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "CODEX-EXEC",
+      "service": "Codex non-interactive mode (codex exec)",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://learn.chatgpt.com/docs/non-interactive-mode.md"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "codex-exec"
+      ],
+      "affected": [
+        "references/harness-facts.md"
+      ],
+      "checksum": "df82c4bbf3b5bffca926a244549222c1235154cfba973b9a0bb1d7a0abd28d66",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "CC-SDK-PRESET",
+      "service": "Claude Agent SDK system-prompt presets (claude_code)",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://platform.claude.com/docs/en/agent-sdk/modifying-system-prompts"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "claude-code-sdk"
+      ],
+      "affected": [
+        "references/harness-facts.md",
+        "SKILL.md"
+      ],
+      "checksum": "2e25fe08f5c213094b569bc89783fb1a4628930abb7c6d78d8d6775b8b6cca43",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "CODEX-AGENTS-MULTI",
+      "service": "Codex multi-agent (built-in and custom agents, concurrency cap)",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://developers.openai.com/codex/multi-agent"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "codex-multi-agent"
+      ],
+      "affected": [
+        "references/harness-facts.md"
+      ],
+      "checksum": "69ab2442ada59e81afcd8c133249f086a63340c0413ae8e3f360114d0bf36a57",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "HERMES-HOOKS",
+      "service": "Hermes Agent hooks (shell and plugin hooks, pre_tool_call blocking)",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://hermes-agent.nousresearch.com/docs/user-guide/features/hooks"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "hermes-hooks"
+      ],
+      "affected": [
+        "references/harness-facts.md"
+      ],
+      "checksum": "53ac2271e3330eaffa1795f98e70b46e355df4a3062ffc1300bd4e75de9ba749",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "HERMES-TOOLS",
+      "service": "Hermes Agent tools (clarify, delegate_task, toolsets)",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://hermes-agent.nousresearch.com/docs/user-guide/features/tools"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "hermes-tools"
+      ],
+      "affected": [
+        "references/harness-facts.md",
+        "SKILL.md"
+      ],
+      "checksum": "c36a5d7fd224b4859f82e252e12b19717e8585baedb502579732dcb1673e4550",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "GH-CLI",
+      "service": "GitHub CLI release notes (issue types, sub-issues, dependencies; name-based project fields)",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://github.com/cli/cli/releases/tag/v2.94.0",
+        "secondary": "https://github.com/cli/cli/releases/tag/v2.97.0"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "github-cli"
+      ],
+      "affected": [
+        "references/harness-facts.md",
+        "SKILL.md"
+      ],
+      "checksum": "187fc0364ecccb0237c8522b4f9b5570c86f1c6e439e7ffe6b5d68cc30e2e18f",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "CODEX-CONFIG",
+      "service": "Codex config.toml (project trust, model and model_reasoning_effort keys)",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://learn.chatgpt.com/docs/config-file/config-basic"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "codex-config"
+      ],
+      "affected": [
+        "references/harness-facts.md",
+        "SKILL.md"
+      ],
+      "checksum": "63f78a58c0c11958ed1d458a512ef3ff7a2f1282587e4b637ea20b659957f308",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "CC-CLI",
+      "service": "Claude Code CLI reference (--model and --effort flags, model aliases and effort levels)",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://code.claude.com/docs/en/cli-reference.md",
+        "secondary": "https://code.claude.com/docs/en/model-config.md"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "claude-code-cli"
+      ],
+      "affected": [
+        "references/harness-facts.md",
+        "SKILL.md"
+      ],
+      "checksum": "89b09b6951fb39303d6d765ce5d7c60f2f6fad83ba5103e4a0b8285f2c64f570",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "CC-SUBAGENT-ENV",
+      "service": "Claude Code subagent concurrency and nesting env caps (CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS, CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH)",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://code.claude.com/docs/en/sub-agents.md"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "claude-code-subagents"
+      ],
+      "affected": [
+        "references/harness-facts.md"
+      ],
+      "checksum": "6dbb7c109bbfced8fa652143807eae143e318d928c1000b438d2a8ead81cb099",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "GH-APP-PERMS",
+      "service": "GitHub App permission names and the endpoints each one unlocks",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://docs.github.com/en/rest/authentication/permissions-required-for-github-apps?apiVersion=2022-11-28"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "github-apps"
+      ],
+      "affected": [
+        "references/github-app.md"
+      ],
+      "checksum": "17135426887fd90762660b90b983af284839e1b4dcd052f1cf3d71c4aba2652c",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "GH-APP-TOKEN",
+      "service": "actions/create-github-app-token — major version, inputs, outputs, token lifetime",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://github.com/actions/create-github-app-token"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "github-app-token-action"
+      ],
+      "affected": [
+        "references/github-app.md"
+      ],
+      "checksum": "d63614af681afbc9432860a369dae13f1f03a11f6ef39c1b6f8c461a721b5426",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "GH-APP-INSTALLS",
+      "service": "GET /orgs/{org}/installations — listing an organization's App installations",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://docs.github.com/en/rest/orgs/orgs?apiVersion=2022-11-28"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "github-apps"
+      ],
+      "affected": [
+        "references/github-app.md"
+      ],
+      "checksum": "d6c0b8c21655fc731862be64e1dedad471fa41b5b41c91a078e161574b989539",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "CC-TELEMETRY",
+      "service": "Claude Code monitoring and OpenTelemetry export (skill_activated event, OTEL_LOG_TOOL_DETAILS)",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://code.claude.com/docs/en/monitoring-usage.md"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "claude-code-telemetry"
+      ],
+      "affected": [
+        "references/harness-facts.md"
+      ],
+      "checksum": "973aedfbccdcc0cdd027bff4b18fce5b29236035ba0959e61abc45fd7b7c44c1",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "CODEX-OTEL",
+      "service": "Codex OpenTelemetry log export and the [otel] config table",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://learn.chatgpt.com/docs/config-file/config-advanced.md"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "codex-telemetry"
+      ],
+      "affected": [
+        "references/harness-facts.md"
+      ],
+      "checksum": "0321ba5779cf660fc379abbf03935e2ba0c86ec2977815581208de61f6a7a586",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "HERMES-CURATOR",
+      "service": "Hermes Curator: the background maintenance pass over agent-created skills",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://hermes-agent.nousresearch.com/docs/user-guide/features/curator"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "hermes-curator"
+      ],
+      "affected": [
+        "references/harness-facts.md"
+      ],
+      "checksum": "1f2f97f0ca0efc2ec47a18cf2491fffb04ca8c5b6cddd0f3bbfdddf994f802a5",
+      "retrievedAt": "2026-09-03T10:10:17.840Z"
+    },
+    {
+      "id": "GH-ACTIONS-OIDC",
+      "service": "GitHub Actions OIDC identity, audience and fork claim behavior",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://docs.github.com/en/actions/reference/security/oidc"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "github-actions-oidc"
+      ],
+      "affected": [
+        "references/github-app.md"
+      ],
+      "checksum": "1e77d8a2433cd743449ad5113a05d775304746c5dc28e717782675a01255a3aa",
+      "retrievedAt": "2026-09-11T10:26:56.751Z"
+    },
+    {
+      "id": "GH-INSTALLATION-TOKENS",
+      "service": "GitHub App installation-token creation, repository enumeration and revocation",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://docs.github.com/en/rest/apps/apps?apiVersion=2022-11-28",
+        "secondary": "https://docs.github.com/en/rest/apps/installations?apiVersion=2022-11-28"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "github-app-installation-tokens"
+      ],
+      "affected": [
+        "references/github-app.md"
+      ],
+      "checksum": "bf9d394360cef4e84042bb4520b210ab9dd9cbe37b0a2c20c1188ad9312cdba9",
+      "retrievedAt": "2026-09-11T10:26:56.751Z"
+    },
+    {
+      "id": "CF-WORKERS-REQUEST",
+      "service": "Cloudflare Workers Request cache modes and subrequest controls",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://developers.cloudflare.com/workers/runtime-apis/request/"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "cloudflare-worker-request"
+      ],
+      "affected": [
+        "references/github-app.md"
+      ],
+      "checksum": "a60230d9d16eb86933ce43ef5c2a2ef84920f86b5d5f46cd167c7ebc9dd5d2a5",
+      "retrievedAt": "2026-09-11T10:26:56.751Z"
+    },
+    {
+      "id": "CF-RATE-LIMIT",
+      "service": "Cloudflare Workers rate-limit binding locality and consistency",
+      "kind": "official-docs",
+      "stability": "vendor-docs",
+      "thresholdDays": 14,
+      "critical": false,
+      "urls": {
+        "primary": "https://developers.cloudflare.com/workers/runtime-apis/bindings/rate-limit/"
+      },
+      "versionDetection": {
+        "type": "manual-review"
+      },
+      "topics": [
+        "cloudflare-rate-limit"
+      ],
+      "affected": [
+        "references/github-app.md"
+      ],
+      "checksum": "613c451e935526d57362d3c81cb7c1d602f28378bff32e0b79a06d7151d2b76f",
+      "retrievedAt": "2026-09-11T10:26:56.751Z"
+    }
+  ]
+}