@redditech/agent-protocol 0.0.0-stage → 0.2.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 +89 -0
- package/LICENSE +21 -0
- package/README.md +394 -2
- package/dist/adl.d.ts +141 -0
- package/dist/adl.js +3601 -0
- package/dist/agent-stack-fixtures.d.ts +743 -0
- package/dist/agent-stack-fixtures.js +1554 -0
- package/dist/ai-catalog.d.ts +128 -0
- package/dist/ai-catalog.js +373 -0
- package/dist/attestation-reputation.d.ts +102 -0
- package/dist/attestation-reputation.js +279 -0
- package/dist/audd-rail-config.d.ts +102 -0
- package/dist/audd-rail-config.js +294 -0
- package/dist/browser-wallet-approval.d.ts +293 -0
- package/dist/browser-wallet-approval.js +1201 -0
- package/dist/discovery-source.d.ts +115 -0
- package/dist/discovery-source.js +251 -0
- package/dist/evidence-archive.d.ts +73 -0
- package/dist/evidence-archive.js +238 -0
- package/dist/index.d.ts +23 -0
- package/dist/index.js +23 -0
- package/dist/mpp-tempo-receipt-shapes.d.ts +201 -0
- package/dist/mpp-tempo-receipt-shapes.js +330 -0
- package/dist/okf-adapter.d.ts +229 -0
- package/dist/okf-adapter.js +556 -0
- package/dist/okf-conformance.d.ts +208 -0
- package/dist/okf-conformance.js +651 -0
- package/dist/okf-instruction-safety.d.ts +192 -0
- package/dist/okf-instruction-safety.js +509 -0
- package/dist/onboarding-analyser-handoff.d.ts +391 -0
- package/dist/onboarding-analyser-handoff.js +959 -0
- package/dist/onboarding-state-machine.d.ts +228 -0
- package/dist/onboarding-state-machine.js +432 -0
- package/dist/payment-records.d.ts +181 -0
- package/dist/payment-records.js +599 -0
- package/dist/policy.d.ts +33 -0
- package/dist/policy.js +45 -0
- package/dist/provider-trust.d.ts +113 -0
- package/dist/provider-trust.js +346 -0
- package/dist/quasar-registry-compatibility.d.ts +113 -0
- package/dist/quasar-registry-compatibility.js +214 -0
- package/dist/ranking-explainability.d.ts +202 -0
- package/dist/ranking-explainability.js +302 -0
- package/dist/receipt-v2.d.ts +202 -0
- package/dist/receipt-v2.js +418 -0
- package/dist/repo-explorer-evidence-manifest.d.ts +387 -0
- package/dist/repo-explorer-evidence-manifest.js +1187 -0
- package/dist/source-diagnostics.d.ts +84 -0
- package/dist/source-diagnostics.js +193 -0
- package/dist/source-trust-conformance-matrix.d.ts +207 -0
- package/dist/source-trust-conformance-matrix.js +672 -0
- package/examples/ard-no-spend-ai-catalog.json +51 -0
- package/examples/ard-no-spend-demo.mjs +355 -0
- package/examples/interpretation-guide-scenarios.mjs +302 -0
- package/package.json +144 -4
|
@@ -0,0 +1,387 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Repo explorer evidence manifest for static fixture ingestion (#470,
|
|
3
|
+
* epic #468 / #400).
|
|
4
|
+
*
|
|
5
|
+
* FastContext-style (arXiv:2606.14066) exploration/solve split, RAP-owned:
|
|
6
|
+
* repository EXPLORATION is read-only and returns compact file/line citations
|
|
7
|
+
* with short relevance reasons — never broad context dumps and never a
|
|
8
|
+
* full-repo ingest. This module defines the typed contract for that evidence
|
|
9
|
+
* (`reddi.repo-explorer-evidence-manifest.v1`), validates candidate manifests
|
|
10
|
+
* fail-closed, bridges accepted manifests onto the #509/#575 onboarding
|
|
11
|
+
* `static-agent-stack-snapshot` / `snapshotRef` provenance surface by
|
|
12
|
+
* reference, and projects them toward the shipped #403/#404/#421/#405/#406
|
|
13
|
+
* vocabularies.
|
|
14
|
+
*
|
|
15
|
+
* The manifest DESCRIBES exploration evidence a caller already holds; this
|
|
16
|
+
* module never performs exploration. It mirrors the shape of the OpenClaw-side
|
|
17
|
+
* `openclaw.repo-explorer-evidence.v0.1` schema but is RAP-owned and
|
|
18
|
+
* self-contained — not an import, not a runtime dependency.
|
|
19
|
+
*
|
|
20
|
+
* This module is PURE and self-contained (zero imports — the #575/#584/#585
|
|
21
|
+
* pattern): no network, no filesystem access, no repo fetch/clone, no URL
|
|
22
|
+
* ingestion, no dependency install, no LLM/provider call, no MCP/tool call,
|
|
23
|
+
* no script or hook execution, no service startup, no wallet/RPC, no payment
|
|
24
|
+
* activation, no hosted write, no marketplace publication, no
|
|
25
|
+
* trust/reputation mutation. It only analyses in-memory data the caller
|
|
26
|
+
* already holds. Fail-closed on malformed input and on any request to
|
|
27
|
+
* fetch/clone/execute/install/ingest.
|
|
28
|
+
*
|
|
29
|
+
* ─────────────────────────────────────────────────────────────────────────────
|
|
30
|
+
* REVIEW-ONLY BOUNDARY: explorer evidence is LOCALIZATION EVIDENCE for static
|
|
31
|
+
* review — never approval to install, run, execute, or adopt the explored
|
|
32
|
+
* repository or any content it cites. A `valid` verdict permits static
|
|
33
|
+
* review/analysis and provenance attachment ONLY. Those denials hold
|
|
34
|
+
* regardless of verdict — see `reviewBoundary` on every report.
|
|
35
|
+
* ─────────────────────────────────────────────────────────────────────────────
|
|
36
|
+
*/
|
|
37
|
+
export declare const REPO_EXPLORER_EVIDENCE_MANIFEST_SCHEMA_VERSION: "reddi.repo-explorer-evidence-manifest.v1";
|
|
38
|
+
/** Source trust boundary — hard-coded. Explored repositories are always
|
|
39
|
+
* external and untrusted; imported content can never self-assert trust. */
|
|
40
|
+
export declare const REPO_EXPLORER_SOURCE_TRUST: "external_untrusted";
|
|
41
|
+
export type RepoExplorerSourceTrust = typeof REPO_EXPLORER_SOURCE_TRUST;
|
|
42
|
+
/** The read-only explorer contract statement carried verbatim on every
|
|
43
|
+
* normalized manifest. */
|
|
44
|
+
export declare const REPO_EXPLORER_READ_ONLY_CONTRACT: "Read-only exploration evidence: this manifest DESCRIBES observed repository content (file paths, line ranges, short relevance reasons). It is localization evidence for static review only \u2014 never approval to install, run, execute, ingest, or adopt the explored repository or any content it cites.";
|
|
45
|
+
/** Severity vocabulary — the repo-wide static-analysis vocabulary shared with
|
|
46
|
+
* `source-diagnostics.ts`, `okf-conformance.ts`, and `okf-instruction-safety.ts`. */
|
|
47
|
+
export type RepoExplorerEvidenceSeverity = 'info' | 'warning' | 'blocked';
|
|
48
|
+
/** Structured, deterministic reason codes for every diagnostic this module emits. */
|
|
49
|
+
export type RepoExplorerEvidenceReasonCode = 'manifest_malformed' | 'operation_not_permitted' | 'source_malformed' | 'unsafe_source_url' | 'commit_unresolved' | 'trust_boundary_invalid' | 'explorer_contract_invalid' | 'timestamp_malformed' | 'query_missing' | 'evidence_empty' | 'evidence_entry_malformed' | 'malformed_evidence_path' | 'unsafe_evidence_path' | 'invalid_line_range' | 'line_window_exceeded' | 'missing_relevance_reason' | 'relevance_reason_too_long' | 'duplicate_evidence_entry' | 'generated_path_cited' | 'excluded_path_cited' | 'exclusion_entry_malformed' | 'open_question_malformed';
|
|
50
|
+
export type RepoExplorerEvidenceDiagnostic = {
|
|
51
|
+
severity: RepoExplorerEvidenceSeverity;
|
|
52
|
+
code: RepoExplorerEvidenceReasonCode;
|
|
53
|
+
/** JSON-path-ish locator into the candidate manifest, e.g. `$.evidence[2].path`. */
|
|
54
|
+
path: string;
|
|
55
|
+
message: string;
|
|
56
|
+
};
|
|
57
|
+
export type RepoExplorerLineRangeInput = {
|
|
58
|
+
start: number;
|
|
59
|
+
end: number;
|
|
60
|
+
};
|
|
61
|
+
export type RepoExplorerEvidenceEntryInput = {
|
|
62
|
+
/** Repo-root-relative POSIX path. Absolute paths, URI schemes, traversal,
|
|
63
|
+
* backslashes, and control characters all fail closed. */
|
|
64
|
+
path: string;
|
|
65
|
+
lines: RepoExplorerLineRangeInput;
|
|
66
|
+
/** Short, task-specific relevance reason (required, non-empty). */
|
|
67
|
+
reason: string;
|
|
68
|
+
matchedTerms?: string[];
|
|
69
|
+
};
|
|
70
|
+
export type RepoExplorerExclusionKind = 'generated' | 'noisy' | 'binary' | 'irrelevant' | 'secret_risk';
|
|
71
|
+
export type RepoExplorerExclusionInput = {
|
|
72
|
+
/** Repo-root-relative path or directory prefix (a trailing `/**` or `/*`
|
|
73
|
+
* glob suffix is accepted and normalized away). */
|
|
74
|
+
path: string;
|
|
75
|
+
reason: string;
|
|
76
|
+
kind?: RepoExplorerExclusionKind;
|
|
77
|
+
};
|
|
78
|
+
export type RepoExplorerContractInput = {
|
|
79
|
+
/** Only `read_only` is accepted; anything else fails closed. */
|
|
80
|
+
mode?: string;
|
|
81
|
+
toolsAllowed?: string[];
|
|
82
|
+
toolsForbidden?: string[];
|
|
83
|
+
maxFiles?: number;
|
|
84
|
+
lineWindow?: number;
|
|
85
|
+
};
|
|
86
|
+
export type RepoExplorerSourceInput = {
|
|
87
|
+
/** Public https repo/source URL. Never fetched here. */
|
|
88
|
+
repoUrl: string;
|
|
89
|
+
/** Resolved commit SHA (7–64 hex). Branch names / `HEAD` are not resolved
|
|
90
|
+
* commits and fail closed. */
|
|
91
|
+
resolvedCommit: string;
|
|
92
|
+
defaultBranch?: string;
|
|
93
|
+
};
|
|
94
|
+
export type RepoExplorerEvidenceManifestInput = {
|
|
95
|
+
manifestId?: string;
|
|
96
|
+
/** RFC3339 UTC capture timestamp — required: provenance without a capture
|
|
97
|
+
* time is not acceptable evidence. */
|
|
98
|
+
generatedAt: string;
|
|
99
|
+
source: RepoExplorerSourceInput;
|
|
100
|
+
/** Optional in input, but only `external_untrusted` is accepted; the
|
|
101
|
+
* normalized manifest hard-codes it either way. */
|
|
102
|
+
sourceTrust?: string;
|
|
103
|
+
/** Task-specific exploration query the evidence answers. */
|
|
104
|
+
explorationQuery: string;
|
|
105
|
+
explorer?: RepoExplorerContractInput;
|
|
106
|
+
evidence: RepoExplorerEvidenceEntryInput[];
|
|
107
|
+
exclusions?: RepoExplorerExclusionInput[];
|
|
108
|
+
openQuestions?: string[];
|
|
109
|
+
};
|
|
110
|
+
/**
|
|
111
|
+
* FAIL-CLOSED operation flags: every one of these is refused with
|
|
112
|
+
* `operation_not_permitted`. They exist only so requests can be rejected
|
|
113
|
+
* deterministically — this module never fetches, clones, ingests, executes,
|
|
114
|
+
* or installs anything.
|
|
115
|
+
*/
|
|
116
|
+
export type RepoExplorerEvidenceOptions = {
|
|
117
|
+
fetchRepo?: boolean;
|
|
118
|
+
cloneRepo?: boolean;
|
|
119
|
+
ingestFullRepo?: boolean;
|
|
120
|
+
executeContent?: boolean;
|
|
121
|
+
installDependencies?: boolean;
|
|
122
|
+
invokeLlm?: boolean;
|
|
123
|
+
};
|
|
124
|
+
export type RepoExplorerEvidenceEntry = {
|
|
125
|
+
path: string;
|
|
126
|
+
lines: {
|
|
127
|
+
start: number;
|
|
128
|
+
end: number;
|
|
129
|
+
};
|
|
130
|
+
reason: string;
|
|
131
|
+
matchedTerms: string[];
|
|
132
|
+
/** True when the cited path matched the default generated/noisy path set. */
|
|
133
|
+
generatedOrNoisy: boolean;
|
|
134
|
+
};
|
|
135
|
+
export type RepoExplorerExclusion = {
|
|
136
|
+
path: string;
|
|
137
|
+
reason: string;
|
|
138
|
+
kind?: RepoExplorerExclusionKind;
|
|
139
|
+
};
|
|
140
|
+
export type RepoExplorerContract = {
|
|
141
|
+
mode: 'read_only';
|
|
142
|
+
toolsAllowed: string[];
|
|
143
|
+
toolsForbidden: string[];
|
|
144
|
+
maxFiles?: number;
|
|
145
|
+
lineWindow?: number;
|
|
146
|
+
};
|
|
147
|
+
export declare const REPO_EXPLORER_DEFAULT_TOOLS_ALLOWED: readonly ["list_files", "read_file", "search_text"];
|
|
148
|
+
export declare const REPO_EXPLORER_DEFAULT_TOOLS_FORBIDDEN: readonly ["execute", "install", "network_fetch", "write_file", "spawn_process"];
|
|
149
|
+
export type RepoExplorerEvidenceManifest = {
|
|
150
|
+
schemaVersion: typeof REPO_EXPLORER_EVIDENCE_MANIFEST_SCHEMA_VERSION;
|
|
151
|
+
manifestId: string;
|
|
152
|
+
generatedAt: string;
|
|
153
|
+
source: {
|
|
154
|
+
repoUrl: string;
|
|
155
|
+
resolvedCommit: string;
|
|
156
|
+
defaultBranch?: string;
|
|
157
|
+
};
|
|
158
|
+
/** Hard-coded: explored repositories are always external and untrusted. */
|
|
159
|
+
sourceTrust: RepoExplorerSourceTrust;
|
|
160
|
+
explorationQuery: string;
|
|
161
|
+
explorer: RepoExplorerContract;
|
|
162
|
+
/** Verbatim copy of `REPO_EXPLORER_READ_ONLY_CONTRACT`. */
|
|
163
|
+
readOnlyContract: typeof REPO_EXPLORER_READ_ONLY_CONTRACT;
|
|
164
|
+
evidence: RepoExplorerEvidenceEntry[];
|
|
165
|
+
exclusions: RepoExplorerExclusion[];
|
|
166
|
+
openQuestions: string[];
|
|
167
|
+
/** Static fixture ingestion preserves this manifest as provenance WITHOUT a
|
|
168
|
+
* full-repo ingest — always false, never overridable. */
|
|
169
|
+
fullRepoIngested: false;
|
|
170
|
+
staticOnly: true;
|
|
171
|
+
};
|
|
172
|
+
export type RepoExplorerEvidenceVerdict = 'valid' | 'warning' | 'blocked';
|
|
173
|
+
/** What an accepted manifest permits — and what stays permanently denied. */
|
|
174
|
+
export declare const REPO_EXPLORER_EVIDENCE_PERMITTED_USE: readonly ["static_review", "static_analysis", "fixture_ingestion_provenance", "operator_review_payload", "conformance_reporting"];
|
|
175
|
+
export declare const REPO_EXPLORER_EVIDENCE_DENIED_USE: readonly ["repo_fetch_or_clone", "full_repo_ingestion", "dependency_install", "script_or_tool_execution", "skill_installation", "agent_registration", "marketplace_publication", "hosted_registry_write", "llm_or_provider_call", "wallet_or_rpc_call", "payment_activation", "trust_or_reputation_mutation"];
|
|
176
|
+
export type RepoExplorerEvidenceManifestReport = {
|
|
177
|
+
schemaVersion: typeof REPO_EXPLORER_EVIDENCE_MANIFEST_SCHEMA_VERSION;
|
|
178
|
+
verdict: RepoExplorerEvidenceVerdict;
|
|
179
|
+
/** Normalized manifest — null iff the verdict is `blocked` (fail-closed:
|
|
180
|
+
* a blocked candidate never yields a usable manifest). */
|
|
181
|
+
manifest: RepoExplorerEvidenceManifest | null;
|
|
182
|
+
diagnostics: RepoExplorerEvidenceDiagnostic[];
|
|
183
|
+
/** Deduped codes across all diagnostics, in first-seen order. */
|
|
184
|
+
codes: RepoExplorerEvidenceReasonCode[];
|
|
185
|
+
/**
|
|
186
|
+
* REVIEW-ONLY boundary: identical on every report, independent of verdict.
|
|
187
|
+
* Explorer output is localization evidence, not approval to install/run/adopt.
|
|
188
|
+
*/
|
|
189
|
+
reviewBoundary: {
|
|
190
|
+
permittedUse: typeof REPO_EXPLORER_EVIDENCE_PERMITTED_USE;
|
|
191
|
+
deniedUse: typeof REPO_EXPLORER_EVIDENCE_DENIED_USE;
|
|
192
|
+
};
|
|
193
|
+
/** Hard-coded false guardrails — this module never touches any live surface. */
|
|
194
|
+
guardrails: {
|
|
195
|
+
network: false;
|
|
196
|
+
fileSystemRead: false;
|
|
197
|
+
repoFetched: false;
|
|
198
|
+
repoCloned: false;
|
|
199
|
+
fullRepoIngested: false;
|
|
200
|
+
executed: false;
|
|
201
|
+
installed: false;
|
|
202
|
+
urlIngested: false;
|
|
203
|
+
llmInvoked: false;
|
|
204
|
+
mcpInvoked: false;
|
|
205
|
+
hostedWrite: false;
|
|
206
|
+
walletOrRpc: false;
|
|
207
|
+
paymentActivated: false;
|
|
208
|
+
trustMutated: false;
|
|
209
|
+
instructionsTrusted: false;
|
|
210
|
+
};
|
|
211
|
+
notes: string[];
|
|
212
|
+
};
|
|
213
|
+
/** Directory segments that mark generated/vendored/noisy content. */
|
|
214
|
+
export declare const REPO_EXPLORER_NOISY_SEGMENTS: readonly ["node_modules", "dist", "build", "out", ".next", "coverage", "vendor", ".git", "target", "__pycache__", ".venv"];
|
|
215
|
+
/** Basename suffixes that mark generated/minified/noisy content. */
|
|
216
|
+
export declare const REPO_EXPLORER_NOISY_SUFFIXES: readonly [".lock", ".min.js", ".min.css", ".map", ".snap", ".tsbuildinfo"];
|
|
217
|
+
/** Exact basenames that mark generated lockfile/noise content. */
|
|
218
|
+
export declare const REPO_EXPLORER_NOISY_BASENAMES: readonly ["package-lock.json", "yarn.lock", "pnpm-lock.yaml", "bun.lockb", "cargo.lock"];
|
|
219
|
+
/** Deterministic generated/noisy classification for a repo-relative path. */
|
|
220
|
+
export declare function isGeneratedOrNoisyPath(path: string): {
|
|
221
|
+
noisy: boolean;
|
|
222
|
+
matched: string | null;
|
|
223
|
+
};
|
|
224
|
+
type PathProblem = {
|
|
225
|
+
code: 'malformed_evidence_path' | 'unsafe_evidence_path';
|
|
226
|
+
message: string;
|
|
227
|
+
};
|
|
228
|
+
/**
|
|
229
|
+
* Deterministic fail-closed safety check for a repo-root-relative citation
|
|
230
|
+
* path. Rejects: empty/non-string paths, control characters, backslash
|
|
231
|
+
* separators, URI schemes (`file://`, `http://`, …) and Windows drive
|
|
232
|
+
* prefixes, absolute paths, home-directory expansion, `..` traversal
|
|
233
|
+
* (literal or percent-encoded), and empty/`.` segments.
|
|
234
|
+
*/
|
|
235
|
+
export declare function repoRelativePathProblem(value: unknown): PathProblem | null;
|
|
236
|
+
/**
|
|
237
|
+
* Validates a candidate repo explorer evidence manifest, fail-closed.
|
|
238
|
+
* Pure static analysis over in-memory data: nothing is fetched, read from
|
|
239
|
+
* disk, executed, or ingested. A `blocked` verdict yields `manifest: null`.
|
|
240
|
+
*/
|
|
241
|
+
export declare function validateRepoExplorerEvidenceManifest(input: unknown, options?: RepoExplorerEvidenceOptions): RepoExplorerEvidenceManifestReport;
|
|
242
|
+
export declare const REPO_EXPLORER_SNAPSHOT_REF_PREFIX: "repo-explorer-evidence:";
|
|
243
|
+
/** Stable by-reference snapshot ref for an accepted manifest. */
|
|
244
|
+
export declare function repoExplorerSnapshotRef(manifest: RepoExplorerEvidenceManifest): string;
|
|
245
|
+
/**
|
|
246
|
+
* Per-citation evidence refs (`repo-explorer-evidence:<id>#<path>:L<start>-L<end>`),
|
|
247
|
+
* suitable as `evidenceRefs` on #575 provenanced fields.
|
|
248
|
+
*/
|
|
249
|
+
export declare function repoExplorerEvidenceRefs(manifest: RepoExplorerEvidenceManifest): string[];
|
|
250
|
+
export type RepoExplorerSnapshotAttachment = {
|
|
251
|
+
/** Structural match for the #575 `OnboardingIntakeSource` intake surface. */
|
|
252
|
+
source: {
|
|
253
|
+
sourceUrl: string;
|
|
254
|
+
snapshotRef: string;
|
|
255
|
+
checkedCommit: string;
|
|
256
|
+
crawlTimestamp: string;
|
|
257
|
+
};
|
|
258
|
+
/** Per-citation refs for #575 provenanced-field verification. */
|
|
259
|
+
evidenceRefs: string[];
|
|
260
|
+
sourceTrust: RepoExplorerSourceTrust;
|
|
261
|
+
/** Provenance is attached BY REFERENCE — the repo is never ingested. */
|
|
262
|
+
fullRepoIngested: false;
|
|
263
|
+
staticOnly: true;
|
|
264
|
+
};
|
|
265
|
+
/**
|
|
266
|
+
* Bridges an accepted report onto the #509/#575 `snapshotRef` surface.
|
|
267
|
+
* Fail-closed: a blocked report (manifest null) can never become provenance.
|
|
268
|
+
*/
|
|
269
|
+
export declare function attachRepoExplorerEvidenceToSnapshot(report: RepoExplorerEvidenceManifestReport): {
|
|
270
|
+
ok: true;
|
|
271
|
+
attachment: RepoExplorerSnapshotAttachment;
|
|
272
|
+
} | {
|
|
273
|
+
ok: false;
|
|
274
|
+
reasonCode: 'manifest_blocked';
|
|
275
|
+
};
|
|
276
|
+
/**
|
|
277
|
+
* Toward #403 (`StaticAgentStackCapabilityInventoryEntry`): the provenance
|
|
278
|
+
* block and evidence refs a capability-inventory entry can carry to justify
|
|
279
|
+
* `discovered` fields, plus compact localization hints for capability review.
|
|
280
|
+
*/
|
|
281
|
+
export type RepoExplorerCapabilityEvidenceProjection = {
|
|
282
|
+
/** Structural match for the #403 entry `provenance` block. */
|
|
283
|
+
provenance: {
|
|
284
|
+
corpusId: string;
|
|
285
|
+
sourceUrl: string;
|
|
286
|
+
checkedCommit: string;
|
|
287
|
+
};
|
|
288
|
+
/** #403 vocabulary: explored repo text is untrusted public text. */
|
|
289
|
+
contentTrustBoundary: 'untrusted_public_text';
|
|
290
|
+
evidenceRefs: string[];
|
|
291
|
+
localizationHints: Array<{
|
|
292
|
+
sourcePath: string;
|
|
293
|
+
lines: {
|
|
294
|
+
start: number;
|
|
295
|
+
end: number;
|
|
296
|
+
};
|
|
297
|
+
relevance: string;
|
|
298
|
+
}>;
|
|
299
|
+
};
|
|
300
|
+
export declare function capabilityInventoryProjection(manifest: RepoExplorerEvidenceManifest): RepoExplorerCapabilityEvidenceProjection;
|
|
301
|
+
/**
|
|
302
|
+
* Toward #404 (`StaticAgentStackConnectorDiagnostic`): field-for-field
|
|
303
|
+
* structural match with our own diagnostic lane literal.
|
|
304
|
+
*/
|
|
305
|
+
export type RepoExplorerConnectorDiagnosticProjection = {
|
|
306
|
+
path: string;
|
|
307
|
+
diagnosticLane: 'repo_explorer_evidence';
|
|
308
|
+
severity: RepoExplorerEvidenceSeverity;
|
|
309
|
+
warningCodes: string[];
|
|
310
|
+
blocksDraftPayload: boolean;
|
|
311
|
+
operatorReviewRequired: boolean;
|
|
312
|
+
message: string;
|
|
313
|
+
};
|
|
314
|
+
export declare function connectorDiagnosticsProjection(report: RepoExplorerEvidenceManifestReport): RepoExplorerConnectorDiagnosticProjection[];
|
|
315
|
+
/** The #421 nine-value risk-category union, mirrored structurally. */
|
|
316
|
+
export type RepoExplorerRiskCategory = 'executable_hook' | 'installer_or_update_script' | 'deploy_capable_command' | 'wallet_rpc_capable_metadata' | 'local_binary_requirement' | 'env_required_connector' | 'mcp_launcher_execution' | 'external_submodule' | 'permission_policy';
|
|
317
|
+
/** Toward #421 (`StaticAgentStackRiskDiagnostic`): structural match. */
|
|
318
|
+
export type RepoExplorerRiskDiagnosticProjection = {
|
|
319
|
+
path: string;
|
|
320
|
+
diagnosticLane: 'static_fixture_risk_taxonomy';
|
|
321
|
+
category: RepoExplorerRiskCategory;
|
|
322
|
+
severity: RepoExplorerEvidenceSeverity;
|
|
323
|
+
warningCodes: string[];
|
|
324
|
+
blocksDraftPayload: boolean;
|
|
325
|
+
operatorReviewRequired: boolean;
|
|
326
|
+
message: string;
|
|
327
|
+
};
|
|
328
|
+
/**
|
|
329
|
+
* Deterministic risk-taxonomy projection over cited evidence paths and
|
|
330
|
+
* matched terms. Localization evidence FLAGS risk for operator review — it
|
|
331
|
+
* never auto-blocks (severity `warning`, `blocksDraftPayload: false`),
|
|
332
|
+
* because citing a risky file is observation, not adoption.
|
|
333
|
+
*/
|
|
334
|
+
export declare function riskTaxonomyProjection(manifest: RepoExplorerEvidenceManifest): RepoExplorerRiskDiagnosticProjection[];
|
|
335
|
+
/**
|
|
336
|
+
* Toward #405 (`StaticAgentStackDraftPayloadReadiness`): structural match.
|
|
337
|
+
* `ready` is NEVER emitted — external_untrusted explorer evidence always
|
|
338
|
+
* requires operator review (matches the #575 static path never emitting
|
|
339
|
+
* `publish_ready`).
|
|
340
|
+
*/
|
|
341
|
+
export type RepoExplorerDraftReadinessProjection = {
|
|
342
|
+
status: 'needs_review' | 'blocked';
|
|
343
|
+
blockers: string[];
|
|
344
|
+
payloadRefs: string[];
|
|
345
|
+
};
|
|
346
|
+
export declare function draftReadinessProjection(report: RepoExplorerEvidenceManifestReport): RepoExplorerDraftReadinessProjection;
|
|
347
|
+
/** Toward #406 (`StaticAgentStackOperatorReviewPayload`): structural subset. */
|
|
348
|
+
export type RepoExplorerOperatorReviewItemProjection = {
|
|
349
|
+
id: string;
|
|
350
|
+
severity: RepoExplorerEvidenceSeverity;
|
|
351
|
+
path?: string;
|
|
352
|
+
source: 'repo_explorer_evidence';
|
|
353
|
+
reasonCodes: string[];
|
|
354
|
+
message: string;
|
|
355
|
+
blocksPublication: boolean;
|
|
356
|
+
recommendedAction: 'approve_after_readiness_gates' | 'review_static_risk' | 'review_unsafe_metadata';
|
|
357
|
+
};
|
|
358
|
+
export type RepoExplorerOperatorReviewProjection = {
|
|
359
|
+
reviewId: string;
|
|
360
|
+
status: 'approve_ready' | 'request_changes' | 'rejected';
|
|
361
|
+
source: {
|
|
362
|
+
sourceUrl: string | null;
|
|
363
|
+
checkedCommit: string | null;
|
|
364
|
+
sourceAuthenticity: 'source_snapshot_recorded';
|
|
365
|
+
providerTrust: 'unverified';
|
|
366
|
+
importedContentTrust: 'untrusted';
|
|
367
|
+
};
|
|
368
|
+
publication: {
|
|
369
|
+
disabled: true;
|
|
370
|
+
requiresOperatorApproval: true;
|
|
371
|
+
};
|
|
372
|
+
reviewItems: RepoExplorerOperatorReviewItemProjection[];
|
|
373
|
+
rawSnapshotRefs: string[];
|
|
374
|
+
};
|
|
375
|
+
export declare function operatorReviewProjection(report: RepoExplorerEvidenceManifestReport): RepoExplorerOperatorReviewProjection;
|
|
376
|
+
/** All projections plus the snapshot attachment, in one deterministic bundle. */
|
|
377
|
+
export type RepoExplorerEvidenceProjections = {
|
|
378
|
+
snapshotAttachment: RepoExplorerSnapshotAttachment | null;
|
|
379
|
+
capabilityInventory: RepoExplorerCapabilityEvidenceProjection | null;
|
|
380
|
+
connectorDiagnostics: RepoExplorerConnectorDiagnosticProjection[];
|
|
381
|
+
riskTaxonomy: RepoExplorerRiskDiagnosticProjection[];
|
|
382
|
+
draftReadiness: RepoExplorerDraftReadinessProjection;
|
|
383
|
+
operatorReview: RepoExplorerOperatorReviewProjection;
|
|
384
|
+
};
|
|
385
|
+
export declare function projectRepoExplorerEvidence(report: RepoExplorerEvidenceManifestReport): RepoExplorerEvidenceProjections;
|
|
386
|
+
export declare const repoExplorerEvidenceManifestFixtures: Record<string, RepoExplorerEvidenceManifestInput>;
|
|
387
|
+
export {};
|