@nebulacomponents/citable 1.3.0 → 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +24 -0
- package/README.md +16 -4
- package/dist/universal/.agents/skills/citable/SKILL.md +7 -1
- package/dist/universal/.agents/skills/citable/VERSION +1 -1
- package/dist/universal/.agents/skills/citable/commands/README.md +5 -2
- package/dist/universal/.agents/skills/citable/commands/measurement.md +5 -5
- package/dist/universal/.agents/skills/citable/commands/observe-and-act.md +40 -0
- package/dist/universal/.agents/skills/citable/manifest.json +11 -8
- package/dist/universal/.agents/skills/citable/references/capability-boundaries.md +8 -8
- package/dist/universal/.agents/skills/citable/schemas/observation.schema.json +20 -0
- package/dist/universal/.agents/skills/citable/schemas/remediation-spec.schema.json +28 -0
- package/dist/universal/.claude/skills/citable/SKILL.md +7 -1
- package/dist/universal/.claude/skills/citable/VERSION +1 -1
- package/dist/universal/.claude/skills/citable/commands/README.md +5 -2
- package/dist/universal/.claude/skills/citable/commands/measurement.md +5 -5
- package/dist/universal/.claude/skills/citable/commands/observe-and-act.md +40 -0
- package/dist/universal/.claude/skills/citable/manifest.json +11 -8
- package/dist/universal/.claude/skills/citable/references/capability-boundaries.md +8 -8
- package/dist/universal/.claude/skills/citable/schemas/observation.schema.json +20 -0
- package/dist/universal/.claude/skills/citable/schemas/remediation-spec.schema.json +28 -0
- package/dist/universal/.cursor/skills/citable/SKILL.md +7 -1
- package/dist/universal/.cursor/skills/citable/VERSION +1 -1
- package/dist/universal/.cursor/skills/citable/commands/README.md +5 -2
- package/dist/universal/.cursor/skills/citable/commands/measurement.md +5 -5
- package/dist/universal/.cursor/skills/citable/commands/observe-and-act.md +40 -0
- package/dist/universal/.cursor/skills/citable/manifest.json +11 -8
- package/dist/universal/.cursor/skills/citable/references/capability-boundaries.md +8 -8
- package/dist/universal/.cursor/skills/citable/schemas/observation.schema.json +20 -0
- package/dist/universal/.cursor/skills/citable/schemas/remediation-spec.schema.json +28 -0
- package/dist/universal/.gemini/skills/citable/SKILL.md +7 -1
- package/dist/universal/.gemini/skills/citable/VERSION +1 -1
- package/dist/universal/.gemini/skills/citable/commands/README.md +5 -2
- package/dist/universal/.gemini/skills/citable/commands/measurement.md +5 -5
- package/dist/universal/.gemini/skills/citable/commands/observe-and-act.md +40 -0
- package/dist/universal/.gemini/skills/citable/manifest.json +11 -8
- package/dist/universal/.gemini/skills/citable/references/capability-boundaries.md +8 -8
- package/dist/universal/.gemini/skills/citable/schemas/observation.schema.json +20 -0
- package/dist/universal/.gemini/skills/citable/schemas/remediation-spec.schema.json +28 -0
- package/dist/universal/.github/skills/citable/SKILL.md +7 -1
- package/dist/universal/.github/skills/citable/VERSION +1 -1
- package/dist/universal/.github/skills/citable/commands/README.md +5 -2
- package/dist/universal/.github/skills/citable/commands/measurement.md +5 -5
- package/dist/universal/.github/skills/citable/commands/observe-and-act.md +40 -0
- package/dist/universal/.github/skills/citable/manifest.json +11 -8
- package/dist/universal/.github/skills/citable/references/capability-boundaries.md +8 -8
- package/dist/universal/.github/skills/citable/schemas/observation.schema.json +20 -0
- package/dist/universal/.github/skills/citable/schemas/remediation-spec.schema.json +28 -0
- package/dist/universal/.kiro/skills/citable/SKILL.md +7 -1
- package/dist/universal/.kiro/skills/citable/VERSION +1 -1
- package/dist/universal/.kiro/skills/citable/commands/README.md +5 -2
- package/dist/universal/.kiro/skills/citable/commands/measurement.md +5 -5
- package/dist/universal/.kiro/skills/citable/commands/observe-and-act.md +40 -0
- package/dist/universal/.kiro/skills/citable/manifest.json +11 -8
- package/dist/universal/.kiro/skills/citable/references/capability-boundaries.md +8 -8
- package/dist/universal/.kiro/skills/citable/schemas/observation.schema.json +20 -0
- package/dist/universal/.kiro/skills/citable/schemas/remediation-spec.schema.json +28 -0
- package/dist/universal/.opencode/skills/citable/SKILL.md +7 -1
- package/dist/universal/.opencode/skills/citable/VERSION +1 -1
- package/dist/universal/.opencode/skills/citable/commands/README.md +5 -2
- package/dist/universal/.opencode/skills/citable/commands/measurement.md +5 -5
- package/dist/universal/.opencode/skills/citable/commands/observe-and-act.md +40 -0
- package/dist/universal/.opencode/skills/citable/manifest.json +11 -8
- package/dist/universal/.opencode/skills/citable/references/capability-boundaries.md +8 -8
- package/dist/universal/.opencode/skills/citable/schemas/observation.schema.json +20 -0
- package/dist/universal/.opencode/skills/citable/schemas/remediation-spec.schema.json +28 -0
- package/dist/universal/.pi/agent/skills/citable/SKILL.md +7 -1
- package/dist/universal/.pi/agent/skills/citable/VERSION +1 -1
- package/dist/universal/.pi/agent/skills/citable/commands/README.md +5 -2
- package/dist/universal/.pi/agent/skills/citable/commands/measurement.md +5 -5
- package/dist/universal/.pi/agent/skills/citable/commands/observe-and-act.md +40 -0
- package/dist/universal/.pi/agent/skills/citable/manifest.json +11 -8
- package/dist/universal/.pi/agent/skills/citable/references/capability-boundaries.md +8 -8
- package/dist/universal/.pi/agent/skills/citable/schemas/observation.schema.json +20 -0
- package/dist/universal/.pi/agent/skills/citable/schemas/remediation-spec.schema.json +28 -0
- package/dist/universal/.qoder/skills/citable/SKILL.md +7 -1
- package/dist/universal/.qoder/skills/citable/VERSION +1 -1
- package/dist/universal/.qoder/skills/citable/commands/README.md +5 -2
- package/dist/universal/.qoder/skills/citable/commands/measurement.md +5 -5
- package/dist/universal/.qoder/skills/citable/commands/observe-and-act.md +40 -0
- package/dist/universal/.qoder/skills/citable/manifest.json +11 -8
- package/dist/universal/.qoder/skills/citable/references/capability-boundaries.md +8 -8
- package/dist/universal/.qoder/skills/citable/schemas/observation.schema.json +20 -0
- package/dist/universal/.qoder/skills/citable/schemas/remediation-spec.schema.json +28 -0
- package/dist/universal/.rovodev/skills/citable/SKILL.md +7 -1
- package/dist/universal/.rovodev/skills/citable/VERSION +1 -1
- package/dist/universal/.rovodev/skills/citable/commands/README.md +5 -2
- package/dist/universal/.rovodev/skills/citable/commands/measurement.md +5 -5
- package/dist/universal/.rovodev/skills/citable/commands/observe-and-act.md +40 -0
- package/dist/universal/.rovodev/skills/citable/manifest.json +11 -8
- package/dist/universal/.rovodev/skills/citable/references/capability-boundaries.md +8 -8
- package/dist/universal/.rovodev/skills/citable/schemas/observation.schema.json +20 -0
- package/dist/universal/.rovodev/skills/citable/schemas/remediation-spec.schema.json +28 -0
- package/dist/universal/.trae/skills/citable/SKILL.md +7 -1
- package/dist/universal/.trae/skills/citable/VERSION +1 -1
- package/dist/universal/.trae/skills/citable/commands/README.md +5 -2
- package/dist/universal/.trae/skills/citable/commands/measurement.md +5 -5
- package/dist/universal/.trae/skills/citable/commands/observe-and-act.md +40 -0
- package/dist/universal/.trae/skills/citable/manifest.json +11 -8
- package/dist/universal/.trae/skills/citable/references/capability-boundaries.md +8 -8
- package/dist/universal/.trae/skills/citable/schemas/observation.schema.json +20 -0
- package/dist/universal/.trae/skills/citable/schemas/remediation-spec.schema.json +28 -0
- package/dist/universal/.trae-cn/skills/citable/SKILL.md +7 -1
- package/dist/universal/.trae-cn/skills/citable/VERSION +1 -1
- package/dist/universal/.trae-cn/skills/citable/commands/README.md +5 -2
- package/dist/universal/.trae-cn/skills/citable/commands/measurement.md +5 -5
- package/dist/universal/.trae-cn/skills/citable/commands/observe-and-act.md +40 -0
- package/dist/universal/.trae-cn/skills/citable/manifest.json +11 -8
- package/dist/universal/.trae-cn/skills/citable/references/capability-boundaries.md +8 -8
- package/dist/universal/.trae-cn/skills/citable/schemas/observation.schema.json +20 -0
- package/dist/universal/.trae-cn/skills/citable/schemas/remediation-spec.schema.json +28 -0
- package/dist/universal/manifest.json +135 -99
- package/package.json +9 -1
- package/schemas/observation.schema.json +20 -0
- package/schemas/remediation-spec.schema.json +28 -0
- package/skill/SKILL.md +7 -1
- package/skill/commands/README.md +5 -2
- package/skill/commands/measurement.md +5 -5
- package/skill/commands/observe-and-act.md +40 -0
- package/skill/references/capability-boundaries.md +8 -8
- package/src/cli/index.js +39 -0
- package/src/commands/applyRemediation.js +57 -0
- package/src/commands/monitor.js +40 -0
- package/src/commands/observe.js +235 -0
- package/src/evidence/run.js +1 -1
- package/src/observations/common.js +61 -0
|
@@ -1,24 +1,25 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.4.0",
|
|
4
4
|
"managedBy": "citable-cli",
|
|
5
5
|
"provider": "trae-cn",
|
|
6
6
|
"providerName": "Trae CN",
|
|
7
7
|
"scope": "bundle",
|
|
8
|
-
"sourcePackage": "@nebulacomponents/citable@1.
|
|
8
|
+
"sourcePackage": "@nebulacomponents/citable@1.4.0",
|
|
9
9
|
"variantPath": ".trae-cn/skills/citable",
|
|
10
10
|
"files": {
|
|
11
11
|
"commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
|
|
12
12
|
"commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
|
|
13
|
-
"commands/measurement.md": "sha256:
|
|
13
|
+
"commands/measurement.md": "sha256:c90352849a589b4cb66d1275a1888e9a2de5052a62399224c42b00f92bbdd814",
|
|
14
|
+
"commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
|
|
14
15
|
"commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
|
|
15
16
|
"commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
|
|
16
|
-
"commands/README.md": "sha256:
|
|
17
|
+
"commands/README.md": "sha256:71b7f2b7fc5e98cfa2b699ec48f58f3b4e32dfb0233315759fc98f7ae7eecac0",
|
|
17
18
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
18
19
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
19
20
|
"references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
|
|
20
21
|
"references/anti-patterns.md": "sha256:de63f8e646af0fbf479b45eb1d050ae62a8637acc320d21b87e4a083fd4c47e7",
|
|
21
|
-
"references/capability-boundaries.md": "sha256:
|
|
22
|
+
"references/capability-boundaries.md": "sha256:0d66909025541c1b4b7f5532750fdbfaed9116fb7fc156a67f290024342e30e4",
|
|
22
23
|
"rubrics/answer-extractability.md": "sha256:c8e741143c34e53afdb3dc7b6976ce7b4485dce13b12d14c193fccb17bacf1da",
|
|
23
24
|
"rubrics/claim-boundedness.md": "sha256:0bab1b85248c252b966175912ebfae13bf18aa7e41573f7466831ac78b5d3e27",
|
|
24
25
|
"rubrics/comparison-fairness.md": "sha256:7afc86903aa4a695060be7b6bca42ba505c106ea7cfa153344189afc5b78a5ba",
|
|
@@ -43,16 +44,18 @@
|
|
|
43
44
|
"schemas/evidence.schema.json": "sha256:76baec7ad7e89c6952473c01dacb9e3b26953c088331e6314d531ce620df9ec1",
|
|
44
45
|
"schemas/experiment.schema.json": "sha256:3cebebc5745a9eb359261408b0a0421b8370d2c94f8244ce939827cd9da41cb6",
|
|
45
46
|
"schemas/finding.schema.json": "sha256:85907cd04cd8d2fe24a1e618e0df7160f6d56aa1818db501f345aebce5eb5edb",
|
|
47
|
+
"schemas/observation.schema.json": "sha256:81d8994591fff4bc23a10f813f1957719d5a2093171520f661ab8792e14748da",
|
|
46
48
|
"schemas/page.schema.json": "sha256:627613c35f461177fa946df08edf66fbf6f6bbdfc57eef812572b3af796d5e07",
|
|
47
49
|
"schemas/project.schema.json": "sha256:ea48fdb6480f7047ba4594bd5908bc1f79c1ad6b9a2c204df900959b5f203dc6",
|
|
48
50
|
"schemas/prompt-result.schema.json": "sha256:b55be47d7d58d7b1dd8c3b1e849e24e55216212c592cde7eb836953379b85737",
|
|
49
51
|
"schemas/prompt.schema.json": "sha256:7f0f50c83a86ac91faa7b79895dbc1fed371e8c0342e18d8c2877cc81f4f0f4c",
|
|
50
52
|
"schemas/query.schema.json": "sha256:3c0793a8c0c48ab39320416790840b345ea987696f35b1cc364f23245a62aacb",
|
|
53
|
+
"schemas/remediation-spec.schema.json": "sha256:6fe8cb773702862ba6d261198bb5cc2dca3eca0a2310a60ebddd04377654df8d",
|
|
51
54
|
"schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
|
|
52
55
|
"scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
|
|
53
|
-
"SKILL.md": "sha256:
|
|
56
|
+
"SKILL.md": "sha256:1e53637f88647dba7bdafc08545ad966f0f77b2814d956d3fbd57b38b3e34fa0",
|
|
54
57
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
55
|
-
"VERSION": "sha256:
|
|
58
|
+
"VERSION": "sha256:78b591400c56b7b67b8cb3b2b8a8e65e9093897f02ce0878e6b5405c68620fa7"
|
|
56
59
|
},
|
|
57
|
-
"treeHash": "sha256:
|
|
60
|
+
"treeHash": "sha256:d5eb2a8baf1230bc82f28610cf0a875f58f5070cb3953838b8310bad07eca012"
|
|
58
61
|
}
|
|
@@ -6,18 +6,18 @@ Use the narrowest supported state. Never promote evidence across rows.
|
|
|
6
6
|
| --- | --- | --- |
|
|
7
7
|
| Allowed by policy | Implemented | Effective robots rule plus crawler-purpose registry decision |
|
|
8
8
|
| Synthetic fetch succeeded | Partial | Captured status, redirects, headers, body from the declared user agent; label identity simulated |
|
|
9
|
-
| Verified crawler reached edge |
|
|
10
|
-
| Observed in production logs |
|
|
11
|
-
| Indexed |
|
|
9
|
+
| Verified crawler reached edge | Imported evidence | `observe logs` record plus provider-published IP verification where supported |
|
|
10
|
+
| Observed in production logs | Imported evidence | Timestamped `observe logs` artifact with URL, status, bytes, latency, cache result, UA, and verification result |
|
|
11
|
+
| Indexed | Google API or imported evidence | `observe index`; Google inspection covers the indexed version, other engines require owner exports |
|
|
12
12
|
| Returned by retrieval | Operator supplied | Provider observation containing retrieved source URL |
|
|
13
|
-
| Cited |
|
|
14
|
-
| Materially supports answer | Human review required |
|
|
13
|
+
| Cited | Import or disclosed adapter | Complete `observe citations` answer with citation URL and product/adapter mode |
|
|
14
|
+
| Materially supports answer | Human review required | `citation_review` maps answer claim to source passage and names the reviewer |
|
|
15
15
|
| Recommended | Operator supplied + review | Explicit recommendation, constraints, provider/mode/locale/time |
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
URL audit mode alone does not prove crawler identity, WAF allowlisting,
|
|
18
18
|
production-log access, index presence, selected canonical, rendered DOM parity,
|
|
19
|
-
or provider citation behavior.
|
|
20
|
-
|
|
19
|
+
or provider citation behavior. Observation collectors can supply narrower
|
|
20
|
+
evidence for these states; unavailable inputs remain `not_evidenced`.
|
|
21
21
|
|
|
22
22
|
Primary-source lineage for these boundaries:
|
|
23
23
|
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$id": "citable://schemas/observation.schema.json",
|
|
3
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
4
|
+
"title": "Collected observation envelope",
|
|
5
|
+
"type": "object",
|
|
6
|
+
"additionalProperties": false,
|
|
7
|
+
"required": ["observation_id", "kind", "state", "collected_at", "collection_method", "confidence", "source", "evidence_hash", "data"],
|
|
8
|
+
"properties": {
|
|
9
|
+
"observation_id": { "type": "string", "minLength": 1 },
|
|
10
|
+
"kind": { "type": "string", "enum": ["render", "index", "citation", "citation_review", "crawler_log", "passage", "canonical_freshness", "performance", "corroboration"] },
|
|
11
|
+
"state": { "type": "string", "enum": ["observed", "not_observed", "not_evidenced", "incomplete", "review_required", "failed"] },
|
|
12
|
+
"collected_at": { "type": "string", "format": "date-time" },
|
|
13
|
+
"collection_method": { "type": "string", "enum": ["live_api", "browser", "owner_import", "synthetic_fetch", "static_analysis", "human_review"] },
|
|
14
|
+
"confidence": { "type": "string", "enum": ["confirmed", "high", "medium", "low", "unknown"] },
|
|
15
|
+
"source": { "type": "string", "minLength": 1 },
|
|
16
|
+
"evidence_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
|
|
17
|
+
"data": { "type": "object" },
|
|
18
|
+
"limitations": { "type": "array", "items": { "type": "string" } }
|
|
19
|
+
}
|
|
20
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$id": "citable://schemas/remediation-spec.schema.json",
|
|
3
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
4
|
+
"title": "Guarded remediation specification",
|
|
5
|
+
"type": "object",
|
|
6
|
+
"additionalProperties": false,
|
|
7
|
+
"required": ["source_run_id", "operations"],
|
|
8
|
+
"properties": {
|
|
9
|
+
"source_run_id": { "type": "string" },
|
|
10
|
+
"operations": {
|
|
11
|
+
"type": "array",
|
|
12
|
+
"items": {
|
|
13
|
+
"type": "object",
|
|
14
|
+
"additionalProperties": false,
|
|
15
|
+
"required": ["operation_id", "file", "find", "replace", "expected_file_hash", "finding_ids"],
|
|
16
|
+
"properties": {
|
|
17
|
+
"operation_id": { "type": "string" },
|
|
18
|
+
"file": { "type": "string", "minLength": 1 },
|
|
19
|
+
"find": { "type": "string", "minLength": 1 },
|
|
20
|
+
"replace": { "type": "string" },
|
|
21
|
+
"expected_file_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
|
|
22
|
+
"finding_ids": { "type": "array", "minItems": 1, "items": { "type": "string" } },
|
|
23
|
+
"reviewer": { "type": "string" }
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
}
|