moflo 4.8.21 → 4.8.22
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/.claude/agents/browser/browser-agent.yaml +182 -182
- package/.claude/agents/core/coder.md +265 -265
- package/.claude/agents/core/planner.md +167 -167
- package/.claude/agents/core/researcher.md +189 -189
- package/.claude/agents/core/reviewer.md +325 -325
- package/.claude/agents/core/tester.md +318 -318
- package/.claude/agents/database-specialist.yaml +21 -21
- package/.claude/agents/dual-mode/codex-coordinator.md +224 -224
- package/.claude/agents/dual-mode/codex-worker.md +211 -211
- package/.claude/agents/dual-mode/dual-orchestrator.md +291 -291
- package/.claude/agents/github/code-review-swarm.md +537 -537
- package/.claude/agents/github/github-modes.md +172 -172
- package/.claude/agents/github/issue-tracker.md +318 -318
- package/.claude/agents/github/multi-repo-swarm.md +552 -552
- package/.claude/agents/github/pr-manager.md +190 -190
- package/.claude/agents/github/project-board-sync.md +508 -508
- package/.claude/agents/github/release-manager.md +366 -366
- package/.claude/agents/github/release-swarm.md +582 -582
- package/.claude/agents/github/repo-architect.md +397 -397
- package/.claude/agents/github/swarm-issue.md +572 -572
- package/.claude/agents/github/swarm-pr.md +427 -427
- package/.claude/agents/github/sync-coordinator.md +451 -451
- package/.claude/agents/github/workflow-automation.md +634 -634
- package/.claude/agents/goal/code-goal-planner.md +445 -445
- package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +129 -129
- package/.claude/agents/hive-mind/queen-coordinator.md +202 -202
- package/.claude/agents/hive-mind/scout-explorer.md +241 -241
- package/.claude/agents/hive-mind/swarm-memory-manager.md +192 -192
- package/.claude/agents/hive-mind/worker-specialist.md +216 -216
- package/.claude/agents/index.yaml +17 -17
- package/.claude/agents/neural/safla-neural.md +73 -73
- package/.claude/agents/project-coordinator.yaml +15 -15
- package/.claude/agents/python-specialist.yaml +21 -21
- package/.claude/agents/reasoning/goal-planner.md +72 -72
- package/.claude/agents/security-auditor.yaml +20 -20
- package/.claude/agents/swarm/adaptive-coordinator.md +395 -395
- package/.claude/agents/swarm/hierarchical-coordinator.md +326 -326
- package/.claude/agents/swarm/mesh-coordinator.md +391 -391
- package/.claude/agents/templates/migration-plan.md +745 -745
- package/.claude/agents/typescript-specialist.yaml +21 -21
- package/.claude/checkpoints/1767754460.json +8 -8
- package/.claude/commands/agents/agent-spawning.md +28 -28
- package/.claude/commands/github/github-modes.md +146 -146
- package/.claude/commands/github/github-swarm.md +121 -121
- package/.claude/commands/github/issue-tracker.md +291 -291
- package/.claude/commands/github/pr-manager.md +169 -169
- package/.claude/commands/github/release-manager.md +337 -337
- package/.claude/commands/github/repo-architect.md +366 -366
- package/.claude/commands/github/sync-coordinator.md +300 -300
- package/.claude/commands/memory/neural.md +47 -47
- package/.claude/commands/sparc/analyzer.md +51 -51
- package/.claude/commands/sparc/architect.md +53 -53
- package/.claude/commands/sparc/ask.md +97 -97
- package/.claude/commands/sparc/batch-executor.md +54 -54
- package/.claude/commands/sparc/code.md +89 -89
- package/.claude/commands/sparc/coder.md +54 -54
- package/.claude/commands/sparc/debug.md +83 -83
- package/.claude/commands/sparc/debugger.md +54 -54
- package/.claude/commands/sparc/designer.md +53 -53
- package/.claude/commands/sparc/devops.md +109 -109
- package/.claude/commands/sparc/docs-writer.md +80 -80
- package/.claude/commands/sparc/documenter.md +54 -54
- package/.claude/commands/sparc/innovator.md +54 -54
- package/.claude/commands/sparc/integration.md +83 -83
- package/.claude/commands/sparc/mcp.md +117 -117
- package/.claude/commands/sparc/memory-manager.md +54 -54
- package/.claude/commands/sparc/optimizer.md +54 -54
- package/.claude/commands/sparc/orchestrator.md +131 -131
- package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
- package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
- package/.claude/commands/sparc/researcher.md +54 -54
- package/.claude/commands/sparc/reviewer.md +54 -54
- package/.claude/commands/sparc/security-review.md +80 -80
- package/.claude/commands/sparc/sparc-modes.md +174 -174
- package/.claude/commands/sparc/sparc.md +111 -111
- package/.claude/commands/sparc/spec-pseudocode.md +80 -80
- package/.claude/commands/sparc/supabase-admin.md +348 -348
- package/.claude/commands/sparc/swarm-coordinator.md +54 -54
- package/.claude/commands/sparc/tdd.md +54 -54
- package/.claude/commands/sparc/tester.md +54 -54
- package/.claude/commands/sparc/tutorial.md +79 -79
- package/.claude/commands/sparc/workflow-manager.md +54 -54
- package/.claude/commands/sparc.md +166 -166
- package/.claude/commands/swarm/analysis.md +95 -95
- package/.claude/commands/swarm/development.md +96 -96
- package/.claude/commands/swarm/examples.md +168 -168
- package/.claude/commands/swarm/maintenance.md +102 -102
- package/.claude/commands/swarm/optimization.md +117 -117
- package/.claude/commands/swarm/research.md +136 -136
- package/.claude/commands/swarm/testing.md +131 -131
- package/.claude/commands/workflows/development.md +77 -77
- package/.claude/commands/workflows/research.md +62 -62
- package/.claude/guidance/moflo-bootstrap.md +126 -126
- package/.claude/guidance/shipped/agent-bootstrap.md +126 -126
- package/.claude/guidance/shipped/guidance-memory-strategy.md +262 -262
- package/.claude/guidance/shipped/memory-strategy.md +204 -204
- package/.claude/guidance/shipped/moflo.md +668 -653
- package/.claude/guidance/shipped/task-swarm-integration.md +441 -441
- package/.claude/helpers/intelligence.cjs +207 -207
- package/.claude/helpers/statusline.cjs +851 -851
- package/.claude/settings.local.json +18 -0
- package/.claude/skills/fl/SKILL.md +583 -583
- package/.claude/skills/flo/SKILL.md +583 -583
- package/.claude/skills/github-code-review/SKILL.md +1140 -1140
- package/.claude/skills/github-multi-repo/SKILL.md +874 -874
- package/.claude/skills/github-project-management/SKILL.md +1277 -1277
- package/.claude/skills/github-release-management/SKILL.md +1081 -1081
- package/.claude/skills/github-workflow-automation/SKILL.md +1065 -1065
- package/.claude/skills/hive-mind-advanced/SKILL.md +712 -712
- package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
- package/.claude/skills/performance-analysis/SKILL.md +563 -563
- package/.claude/skills/sparc-methodology/SKILL.md +1115 -1115
- package/.claude/skills/swarm-advanced/SKILL.md +973 -973
- package/.claude/workflow-state.json +4 -4
- package/LICENSE +21 -21
- package/README.md +685 -685
- package/bin/cli.js +0 -0
- package/bin/gate-hook.mjs +50 -50
- package/bin/gate.cjs +138 -138
- package/bin/generate-code-map.mjs +775 -775
- package/bin/hook-handler.cjs +83 -83
- package/bin/hooks.mjs +656 -656
- package/bin/index-guidance.mjs +892 -892
- package/bin/index-tests.mjs +709 -709
- package/bin/lib/process-manager.mjs +243 -243
- package/bin/lib/registry-cleanup.cjs +41 -41
- package/bin/prompt-hook.mjs +72 -72
- package/bin/semantic-search.mjs +472 -472
- package/bin/session-start-launcher.mjs +238 -238
- package/bin/setup-project.mjs +250 -250
- package/package.json +123 -123
- package/src/@claude-flow/cli/README.md +452 -452
- package/src/@claude-flow/cli/bin/cli.js +180 -180
- package/src/@claude-flow/cli/bin/preinstall.cjs +2 -2
- package/src/@claude-flow/cli/dist/src/commands/completions.js +409 -409
- package/src/@claude-flow/cli/dist/src/commands/doctor.js +5 -1
- package/src/@claude-flow/cli/dist/src/commands/embeddings.js +25 -25
- package/src/@claude-flow/cli/dist/src/commands/github.js +61 -61
- package/src/@claude-flow/cli/dist/src/commands/hive-mind.js +90 -90
- package/src/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
- package/src/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
- package/src/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
- package/src/@claude-flow/cli/dist/src/config/moflo-config.d.ts +3 -0
- package/src/@claude-flow/cli/dist/src/config/moflo-config.js +101 -91
- package/src/@claude-flow/cli/dist/src/index.d.ts +5 -0
- package/src/@claude-flow/cli/dist/src/index.js +44 -0
- package/src/@claude-flow/cli/dist/src/init/claudemd-generator.d.ts +29 -29
- package/src/@claude-flow/cli/dist/src/init/claudemd-generator.js +43 -43
- package/src/@claude-flow/cli/dist/src/init/executor.js +453 -453
- package/src/@claude-flow/cli/dist/src/init/helpers-generator.js +482 -482
- package/src/@claude-flow/cli/dist/src/init/moflo-init.d.ts +30 -30
- package/src/@claude-flow/cli/dist/src/init/moflo-init.js +140 -140
- package/src/@claude-flow/cli/dist/src/init/statusline-generator.js +876 -876
- package/src/@claude-flow/cli/dist/src/memory/memory-initializer.js +371 -371
- package/src/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
- package/src/@claude-flow/cli/dist/src/services/container-worker-pool.d.ts +197 -0
- package/src/@claude-flow/cli/dist/src/services/container-worker-pool.js +584 -0
- package/src/@claude-flow/cli/dist/src/services/daemon-lock.d.ts +14 -0
- package/src/@claude-flow/cli/dist/src/services/daemon-lock.js +1 -1
- package/src/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
- package/src/@claude-flow/cli/package.json +1 -1
- package/src/@claude-flow/guidance/README.md +1195 -1195
- package/src/@claude-flow/guidance/package.json +198 -198
- package/src/@claude-flow/memory/README.md +587 -587
- package/src/@claude-flow/memory/dist/agent-memory-scope.test.js +4 -7
- package/src/@claude-flow/memory/dist/agentdb-backend.d.ts +2 -0
- package/src/@claude-flow/memory/dist/agentdb-backend.js +28 -26
- package/src/@claude-flow/memory/dist/auto-memory-bridge.test.js +36 -39
- package/src/@claude-flow/memory/dist/benchmark.test.js +1 -1
- package/src/@claude-flow/memory/dist/controller-registry.test.js +43 -0
- package/src/@claude-flow/memory/dist/database-provider.d.ts +2 -2
- package/src/@claude-flow/memory/dist/database-provider.js +6 -3
- package/src/@claude-flow/memory/dist/database-provider.test.js +1 -3
- package/src/@claude-flow/memory/dist/hybrid-backend.d.ts +245 -0
- package/src/@claude-flow/memory/dist/hybrid-backend.js +569 -0
- package/src/@claude-flow/memory/dist/hybrid-backend.test.d.ts +8 -0
- package/src/@claude-flow/memory/dist/hybrid-backend.test.js +320 -0
- package/src/@claude-flow/memory/dist/index.d.ts +3 -0
- package/src/@claude-flow/memory/dist/index.js +3 -0
- package/src/@claude-flow/memory/dist/sqlite-backend.d.ts +121 -0
- package/src/@claude-flow/memory/dist/sqlite-backend.js +572 -0
- package/src/@claude-flow/memory/dist/sqljs-backend.d.ts +4 -3
- package/src/@claude-flow/memory/dist/sqljs-backend.js +31 -30
- package/src/@claude-flow/memory/package.json +44 -44
- package/src/@claude-flow/shared/README.md +323 -323
- package/src/@claude-flow/shared/dist/core/config/defaults.js +1 -1
- package/src/@claude-flow/shared/dist/core/config/loader.js +1 -1
- package/src/@claude-flow/shared/dist/core/config/schema.js +1 -1
- package/src/@claude-flow/shared/dist/events/event-store.js +34 -50
- package/src/@claude-flow/shared/dist/events/event-store.test.js +4 -8
- package/src/@claude-flow/shared/dist/hooks/executor.js +4 -7
- package/src/@claude-flow/shared/dist/hooks/safety/file-organization.js +1 -1
- package/src/@claude-flow/shared/dist/hooks/safety/git-commit.js +3 -3
- package/src/@claude-flow/shared/dist/hooks/verify-exports.test.js +6 -6
- package/src/@claude-flow/shared/dist/utils/secure-logger.js +1 -1
- package/src/README.md +493 -493
- package/src/@claude-flow/guidance/dist/adversarial.d.ts +0 -284
- package/src/@claude-flow/guidance/dist/adversarial.js +0 -572
- package/src/@claude-flow/guidance/dist/analyzer.d.ts +0 -530
- package/src/@claude-flow/guidance/dist/analyzer.js +0 -2518
- package/src/@claude-flow/guidance/dist/artifacts.d.ts +0 -283
- package/src/@claude-flow/guidance/dist/artifacts.js +0 -356
- package/src/@claude-flow/guidance/dist/authority.d.ts +0 -290
- package/src/@claude-flow/guidance/dist/authority.js +0 -558
- package/src/@claude-flow/guidance/dist/capabilities.d.ts +0 -209
- package/src/@claude-flow/guidance/dist/capabilities.js +0 -485
- package/src/@claude-flow/guidance/dist/coherence.d.ts +0 -233
- package/src/@claude-flow/guidance/dist/coherence.js +0 -372
- package/src/@claude-flow/guidance/dist/compiler.d.ts +0 -87
- package/src/@claude-flow/guidance/dist/compiler.js +0 -419
- package/src/@claude-flow/guidance/dist/conformance-kit.d.ts +0 -225
- package/src/@claude-flow/guidance/dist/conformance-kit.js +0 -629
- package/src/@claude-flow/guidance/dist/continue-gate.d.ts +0 -214
- package/src/@claude-flow/guidance/dist/continue-gate.js +0 -353
- package/src/@claude-flow/guidance/dist/crypto-utils.d.ts +0 -17
- package/src/@claude-flow/guidance/dist/crypto-utils.js +0 -24
- package/src/@claude-flow/guidance/dist/evolution.d.ts +0 -282
- package/src/@claude-flow/guidance/dist/evolution.js +0 -500
- package/src/@claude-flow/guidance/dist/gates.d.ts +0 -79
- package/src/@claude-flow/guidance/dist/gates.js +0 -302
- package/src/@claude-flow/guidance/dist/gateway.d.ts +0 -206
- package/src/@claude-flow/guidance/dist/gateway.js +0 -452
- package/src/@claude-flow/guidance/dist/generators.d.ts +0 -153
- package/src/@claude-flow/guidance/dist/generators.js +0 -682
- package/src/@claude-flow/guidance/dist/headless.d.ts +0 -177
- package/src/@claude-flow/guidance/dist/headless.js +0 -342
- package/src/@claude-flow/guidance/dist/hooks.d.ts +0 -109
- package/src/@claude-flow/guidance/dist/hooks.js +0 -347
- package/src/@claude-flow/guidance/dist/index.d.ts +0 -205
- package/src/@claude-flow/guidance/dist/index.js +0 -321
- package/src/@claude-flow/guidance/dist/ledger.d.ts +0 -162
- package/src/@claude-flow/guidance/dist/ledger.js +0 -375
- package/src/@claude-flow/guidance/dist/manifest-validator.d.ts +0 -289
- package/src/@claude-flow/guidance/dist/manifest-validator.js +0 -838
- package/src/@claude-flow/guidance/dist/memory-gate.d.ts +0 -222
- package/src/@claude-flow/guidance/dist/memory-gate.js +0 -382
- package/src/@claude-flow/guidance/dist/meta-governance.d.ts +0 -265
- package/src/@claude-flow/guidance/dist/meta-governance.js +0 -348
- package/src/@claude-flow/guidance/dist/optimizer.d.ts +0 -104
- package/src/@claude-flow/guidance/dist/optimizer.js +0 -329
- package/src/@claude-flow/guidance/dist/persistence.d.ts +0 -189
- package/src/@claude-flow/guidance/dist/persistence.js +0 -464
- package/src/@claude-flow/guidance/dist/proof.d.ts +0 -185
- package/src/@claude-flow/guidance/dist/proof.js +0 -238
- package/src/@claude-flow/guidance/dist/retriever.d.ts +0 -116
- package/src/@claude-flow/guidance/dist/retriever.js +0 -394
- package/src/@claude-flow/guidance/dist/ruvbot-integration.d.ts +0 -370
- package/src/@claude-flow/guidance/dist/ruvbot-integration.js +0 -738
- package/src/@claude-flow/guidance/dist/temporal.d.ts +0 -426
- package/src/@claude-flow/guidance/dist/temporal.js +0 -658
- package/src/@claude-flow/guidance/dist/trust.d.ts +0 -283
- package/src/@claude-flow/guidance/dist/trust.js +0 -473
- package/src/@claude-flow/guidance/dist/truth-anchors.d.ts +0 -276
- package/src/@claude-flow/guidance/dist/truth-anchors.js +0 -488
- package/src/@claude-flow/guidance/dist/types.d.ts +0 -378
- package/src/@claude-flow/guidance/dist/types.js +0 -10
- package/src/@claude-flow/guidance/dist/uncertainty.d.ts +0 -372
- package/src/@claude-flow/guidance/dist/uncertainty.js +0 -619
- package/src/@claude-flow/guidance/dist/wasm-kernel.d.ts +0 -48
- package/src/@claude-flow/guidance/dist/wasm-kernel.js +0 -158
|
@@ -1,838 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Manifest Validator & Conformance Suite
|
|
3
|
-
*
|
|
4
|
-
* Validates AgentCellManifest documents against the Agentic Container spec,
|
|
5
|
-
* computes risk scores, selects execution lanes, and fails closed on any
|
|
6
|
-
* validation error. The ConformanceSuite runs golden traces through an
|
|
7
|
-
* evaluator to prove the platform behaves as specified.
|
|
8
|
-
*
|
|
9
|
-
* @module @claude-flow/guidance/manifest-validator
|
|
10
|
-
*/
|
|
11
|
-
// ============================================================================
|
|
12
|
-
// Constants
|
|
13
|
-
// ============================================================================
|
|
14
|
-
const SUPPORTED_API_VERSION = 'agentic_cells.v0_1';
|
|
15
|
-
const SHA256_DIGEST_RE = /^sha256:[a-f0-9]{64}$/;
|
|
16
|
-
/** Maximum budget limits (sanity caps) */
|
|
17
|
-
const MAX_BUDGET_LIMITS = {
|
|
18
|
-
maxWallClockSeconds: 86_400, // 24 hours
|
|
19
|
-
maxToolCalls: 100_000,
|
|
20
|
-
maxBytesEgress: 10_737_418_240, // 10 GiB
|
|
21
|
-
maxTokensInMtok: 100, // 100M tokens
|
|
22
|
-
maxTokensOutMtok: 100, // 100M tokens
|
|
23
|
-
maxMemoryWrites: 1_000_000,
|
|
24
|
-
};
|
|
25
|
-
/** Data sensitivity levels ordered by severity */
|
|
26
|
-
const DATA_SENSITIVITY_LEVELS = ['public', 'internal', 'confidential', 'restricted'];
|
|
27
|
-
/** Write modes for memory policy */
|
|
28
|
-
const WRITE_MODES = ['append', 'overwrite', 'merge'];
|
|
29
|
-
/** Authority scopes for memory policy */
|
|
30
|
-
const AUTHORITY_SCOPES = ['self', 'team', 'tenant', 'global'];
|
|
31
|
-
/** Known tool names the system recognizes */
|
|
32
|
-
const KNOWN_TOOLS = new Set([
|
|
33
|
-
'Read', 'Write', 'Edit', 'MultiEdit', 'Glob', 'Grep',
|
|
34
|
-
'Bash', 'Task', 'TodoWrite', 'NotebookEdit', 'WebFetch', 'WebSearch',
|
|
35
|
-
'mcp_memory', 'mcp_swarm', 'mcp_hooks', 'mcp_agent',
|
|
36
|
-
]);
|
|
37
|
-
/** Trace levels for observability */
|
|
38
|
-
const TRACE_LEVELS = ['none', 'errors', 'decisions', 'full'];
|
|
39
|
-
/** Execution lanes ordered by privilege (lowest to highest) */
|
|
40
|
-
const LANES = ['wasm', 'sandboxed', 'native'];
|
|
41
|
-
// ============================================================================
|
|
42
|
-
// ManifestValidator
|
|
43
|
-
// ============================================================================
|
|
44
|
-
/**
|
|
45
|
-
* Validates AgentCellManifest documents against the Agentic Container spec.
|
|
46
|
-
*
|
|
47
|
-
* Fails closed: any validation error results in a 'reject' decision.
|
|
48
|
-
* Warnings alone do not block admission but may trigger a 'review' decision
|
|
49
|
-
* when the risk score is between thresholds.
|
|
50
|
-
*/
|
|
51
|
-
export class ManifestValidator {
|
|
52
|
-
/** Risk score threshold: below this, admit. Above reject threshold, reject. Between, review. */
|
|
53
|
-
admitThreshold;
|
|
54
|
-
rejectThreshold;
|
|
55
|
-
constructor(options) {
|
|
56
|
-
this.admitThreshold = options?.admitThreshold ?? 30;
|
|
57
|
-
this.rejectThreshold = options?.rejectThreshold ?? 70;
|
|
58
|
-
}
|
|
59
|
-
/**
|
|
60
|
-
* Validate a manifest, compute its risk score, select a lane, and decide admission.
|
|
61
|
-
*
|
|
62
|
-
* FAILS CLOSED: any validation error leads to reject.
|
|
63
|
-
*/
|
|
64
|
-
validate(manifest) {
|
|
65
|
-
const errors = [];
|
|
66
|
-
const warnings = [];
|
|
67
|
-
// Structural validation
|
|
68
|
-
errors.push(...this.validateRequiredFields(manifest));
|
|
69
|
-
errors.push(...this.validateApiVersion(manifest));
|
|
70
|
-
errors.push(...this.validateDigest(manifest));
|
|
71
|
-
errors.push(...this.validateBudgets(manifest.budgets));
|
|
72
|
-
errors.push(...this.validateToolPolicy(manifest.toolPolicy));
|
|
73
|
-
errors.push(...this.validateDataPolicy(manifest.dataPolicy));
|
|
74
|
-
warnings.push(...this.validateWarnings(manifest));
|
|
75
|
-
// Compute risk score (even if there are errors, for diagnostics)
|
|
76
|
-
const riskScore = this.computeRiskScore(manifest);
|
|
77
|
-
// FAIL CLOSED: any error means reject
|
|
78
|
-
if (errors.length > 0) {
|
|
79
|
-
return {
|
|
80
|
-
valid: false,
|
|
81
|
-
errors,
|
|
82
|
-
warnings,
|
|
83
|
-
admissionDecision: 'reject',
|
|
84
|
-
laneSelection: null,
|
|
85
|
-
riskScore,
|
|
86
|
-
};
|
|
87
|
-
}
|
|
88
|
-
// Lane selection
|
|
89
|
-
const laneSelection = this.selectLane(manifest, riskScore);
|
|
90
|
-
// Admission decision based on risk score
|
|
91
|
-
let admissionDecision;
|
|
92
|
-
if (riskScore > this.rejectThreshold) {
|
|
93
|
-
admissionDecision = 'reject';
|
|
94
|
-
}
|
|
95
|
-
else if (riskScore > this.admitThreshold) {
|
|
96
|
-
admissionDecision = 'review';
|
|
97
|
-
}
|
|
98
|
-
else {
|
|
99
|
-
admissionDecision = 'admit';
|
|
100
|
-
}
|
|
101
|
-
return {
|
|
102
|
-
valid: true,
|
|
103
|
-
errors,
|
|
104
|
-
warnings,
|
|
105
|
-
admissionDecision,
|
|
106
|
-
laneSelection,
|
|
107
|
-
riskScore,
|
|
108
|
-
};
|
|
109
|
-
}
|
|
110
|
-
/**
|
|
111
|
-
* Compute a risk score (0-100) from tool risk, data sensitivity, and privilege surface.
|
|
112
|
-
*
|
|
113
|
-
* Components:
|
|
114
|
-
* - tool_risk (0-40): based on tool types and network access
|
|
115
|
-
* - data_sensitivity (0-30): based on sensitivity level and PII
|
|
116
|
-
* - privilege_surface (0-30): based on memory scope, write mode, native threads
|
|
117
|
-
*/
|
|
118
|
-
computeRiskScore(manifest) {
|
|
119
|
-
let toolRisk = 0;
|
|
120
|
-
let dataSensitivity = 0;
|
|
121
|
-
let privilegeSurface = 0;
|
|
122
|
-
// --- Tool risk (0-40) ---
|
|
123
|
-
const tools = manifest.toolPolicy?.toolsAllowed ?? [];
|
|
124
|
-
const networkList = manifest.toolPolicy?.networkAllowlist ?? [];
|
|
125
|
-
// Bash/command execution is high risk
|
|
126
|
-
if (tools.includes('Bash') || tools.includes('bash')) {
|
|
127
|
-
toolRisk += 15;
|
|
128
|
-
}
|
|
129
|
-
// Task spawning
|
|
130
|
-
if (tools.includes('Task') || tools.includes('task')) {
|
|
131
|
-
toolRisk += 8;
|
|
132
|
-
}
|
|
133
|
-
// Write operations
|
|
134
|
-
if (tools.some(t => ['Write', 'Edit', 'MultiEdit', 'NotebookEdit'].includes(t))) {
|
|
135
|
-
toolRisk += 5;
|
|
136
|
-
}
|
|
137
|
-
// MCP tools
|
|
138
|
-
if (tools.some(t => t.startsWith('mcp_'))) {
|
|
139
|
-
toolRisk += 5;
|
|
140
|
-
}
|
|
141
|
-
// Network access
|
|
142
|
-
if (networkList.length > 0) {
|
|
143
|
-
toolRisk += 5;
|
|
144
|
-
}
|
|
145
|
-
// Wildcard in network (already caught as error if not privileged, but score anyway)
|
|
146
|
-
if (networkList.some(h => h === '*' || h.startsWith('*.'))) {
|
|
147
|
-
toolRisk += 10;
|
|
148
|
-
}
|
|
149
|
-
// No confirmation on writes
|
|
150
|
-
if (manifest.toolPolicy && !manifest.toolPolicy.writeActionsRequireConfirmation) {
|
|
151
|
-
toolRisk += 3;
|
|
152
|
-
}
|
|
153
|
-
toolRisk = Math.min(toolRisk, 40);
|
|
154
|
-
// --- Data sensitivity (0-30) ---
|
|
155
|
-
const sensitivityIndex = DATA_SENSITIVITY_LEVELS.indexOf(manifest.dataPolicy?.dataSensitivity);
|
|
156
|
-
if (sensitivityIndex >= 0) {
|
|
157
|
-
dataSensitivity += sensitivityIndex * 8; // 0, 8, 16, 24
|
|
158
|
-
}
|
|
159
|
-
if (manifest.dataPolicy?.piiAllowed) {
|
|
160
|
-
dataSensitivity += 6;
|
|
161
|
-
}
|
|
162
|
-
dataSensitivity = Math.min(dataSensitivity, 30);
|
|
163
|
-
// --- Privilege surface (0-30) ---
|
|
164
|
-
const scopeIndex = AUTHORITY_SCOPES.indexOf(manifest.memoryPolicy?.authorityScope);
|
|
165
|
-
if (scopeIndex >= 0) {
|
|
166
|
-
privilegeSurface += scopeIndex * 5; // 0, 5, 10, 15
|
|
167
|
-
}
|
|
168
|
-
if (manifest.memoryPolicy?.writeMode === 'overwrite') {
|
|
169
|
-
privilegeSurface += 5;
|
|
170
|
-
}
|
|
171
|
-
if (manifest.lanePolicy?.needsNativeThreads) {
|
|
172
|
-
privilegeSurface += 8;
|
|
173
|
-
}
|
|
174
|
-
if (manifest.memoryPolicy && !manifest.memoryPolicy.requiresCoherenceGate) {
|
|
175
|
-
privilegeSurface += 3;
|
|
176
|
-
}
|
|
177
|
-
if (manifest.memoryPolicy && !manifest.memoryPolicy.requiresAntiHallucinationGate) {
|
|
178
|
-
privilegeSurface += 3;
|
|
179
|
-
}
|
|
180
|
-
privilegeSurface = Math.min(privilegeSurface, 30);
|
|
181
|
-
return Math.min(toolRisk + dataSensitivity + privilegeSurface, 100);
|
|
182
|
-
}
|
|
183
|
-
/**
|
|
184
|
-
* Select the execution lane based on risk score and manifest policy.
|
|
185
|
-
*
|
|
186
|
-
* Lane selection rules:
|
|
187
|
-
* - If portabilityRequired or risk <= 30: wasm
|
|
188
|
-
* - If needsNativeThreads and risk > 50: native
|
|
189
|
-
* - Otherwise: sandboxed
|
|
190
|
-
* - Always respect preferredLane if risk score allows it
|
|
191
|
-
* - Risk exceeding maxRiskScore forces the most restrictive lane
|
|
192
|
-
*/
|
|
193
|
-
selectLane(manifest, riskScore) {
|
|
194
|
-
const policy = manifest.lanePolicy;
|
|
195
|
-
// If risk exceeds the manifest's own maxRiskScore, force wasm
|
|
196
|
-
if (riskScore > policy.maxRiskScore) {
|
|
197
|
-
return 'wasm';
|
|
198
|
-
}
|
|
199
|
-
// Portability requirement forces wasm
|
|
200
|
-
if (policy.portabilityRequired) {
|
|
201
|
-
return 'wasm';
|
|
202
|
-
}
|
|
203
|
-
// Native threads require native lane
|
|
204
|
-
if (policy.needsNativeThreads) {
|
|
205
|
-
// Only grant native if risk is acceptable
|
|
206
|
-
if (riskScore <= 50) {
|
|
207
|
-
return 'native';
|
|
208
|
-
}
|
|
209
|
-
return 'sandboxed';
|
|
210
|
-
}
|
|
211
|
-
// Low risk can go to wasm
|
|
212
|
-
if (riskScore <= 20) {
|
|
213
|
-
return policy.preferredLane;
|
|
214
|
-
}
|
|
215
|
-
// Medium risk gets sandboxed
|
|
216
|
-
if (riskScore <= 50) {
|
|
217
|
-
// Respect preference if it's not native
|
|
218
|
-
if (policy.preferredLane !== 'native') {
|
|
219
|
-
return policy.preferredLane;
|
|
220
|
-
}
|
|
221
|
-
return 'sandboxed';
|
|
222
|
-
}
|
|
223
|
-
// High risk gets wasm
|
|
224
|
-
return 'wasm';
|
|
225
|
-
}
|
|
226
|
-
/**
|
|
227
|
-
* Validate budget values: no negatives, within sanity limits.
|
|
228
|
-
*/
|
|
229
|
-
validateBudgets(budgets) {
|
|
230
|
-
const errors = [];
|
|
231
|
-
if (!budgets) {
|
|
232
|
-
errors.push({
|
|
233
|
-
code: 'MISSING_FIELD',
|
|
234
|
-
field: 'budgets',
|
|
235
|
-
message: 'Budget configuration is required',
|
|
236
|
-
severity: 'error',
|
|
237
|
-
});
|
|
238
|
-
return errors;
|
|
239
|
-
}
|
|
240
|
-
const budgetFields = [
|
|
241
|
-
{ key: 'maxWallClockSeconds', max: MAX_BUDGET_LIMITS.maxWallClockSeconds },
|
|
242
|
-
{ key: 'maxToolCalls', max: MAX_BUDGET_LIMITS.maxToolCalls },
|
|
243
|
-
{ key: 'maxBytesEgress', max: MAX_BUDGET_LIMITS.maxBytesEgress },
|
|
244
|
-
{ key: 'maxTokensInMtok', max: MAX_BUDGET_LIMITS.maxTokensInMtok },
|
|
245
|
-
{ key: 'maxTokensOutMtok', max: MAX_BUDGET_LIMITS.maxTokensOutMtok },
|
|
246
|
-
{ key: 'maxMemoryWrites', max: MAX_BUDGET_LIMITS.maxMemoryWrites },
|
|
247
|
-
];
|
|
248
|
-
for (const { key, max } of budgetFields) {
|
|
249
|
-
const value = budgets[key];
|
|
250
|
-
if (value === undefined || value === null) {
|
|
251
|
-
errors.push({
|
|
252
|
-
code: 'MISSING_FIELD',
|
|
253
|
-
field: `budgets.${key}`,
|
|
254
|
-
message: `Budget field "${key}" is required`,
|
|
255
|
-
severity: 'error',
|
|
256
|
-
});
|
|
257
|
-
continue;
|
|
258
|
-
}
|
|
259
|
-
if (typeof value !== 'number' || Number.isNaN(value)) {
|
|
260
|
-
errors.push({
|
|
261
|
-
code: 'INVALID_TYPE',
|
|
262
|
-
field: `budgets.${key}`,
|
|
263
|
-
message: `Budget field "${key}" must be a number`,
|
|
264
|
-
severity: 'error',
|
|
265
|
-
});
|
|
266
|
-
continue;
|
|
267
|
-
}
|
|
268
|
-
if (value < 0) {
|
|
269
|
-
errors.push({
|
|
270
|
-
code: 'BUDGET_NEGATIVE',
|
|
271
|
-
field: `budgets.${key}`,
|
|
272
|
-
message: `Budget field "${key}" must not be negative (got ${value})`,
|
|
273
|
-
severity: 'error',
|
|
274
|
-
});
|
|
275
|
-
}
|
|
276
|
-
if (value > max) {
|
|
277
|
-
errors.push({
|
|
278
|
-
code: 'BUDGET_EXCEED',
|
|
279
|
-
field: `budgets.${key}`,
|
|
280
|
-
message: `Budget field "${key}" exceeds maximum (${value} > ${max})`,
|
|
281
|
-
severity: 'error',
|
|
282
|
-
});
|
|
283
|
-
}
|
|
284
|
-
}
|
|
285
|
-
return errors;
|
|
286
|
-
}
|
|
287
|
-
/**
|
|
288
|
-
* Validate tool policy: network allowlist must not contain wildcards
|
|
289
|
-
* unless the cell explicitly has Bash (privileged).
|
|
290
|
-
*/
|
|
291
|
-
validateToolPolicy(toolPolicy) {
|
|
292
|
-
const errors = [];
|
|
293
|
-
if (!toolPolicy) {
|
|
294
|
-
errors.push({
|
|
295
|
-
code: 'MISSING_FIELD',
|
|
296
|
-
field: 'toolPolicy',
|
|
297
|
-
message: 'Tool policy is required',
|
|
298
|
-
severity: 'error',
|
|
299
|
-
});
|
|
300
|
-
return errors;
|
|
301
|
-
}
|
|
302
|
-
if (!Array.isArray(toolPolicy.toolsAllowed)) {
|
|
303
|
-
errors.push({
|
|
304
|
-
code: 'INVALID_TYPE',
|
|
305
|
-
field: 'toolPolicy.toolsAllowed',
|
|
306
|
-
message: 'toolsAllowed must be an array',
|
|
307
|
-
severity: 'error',
|
|
308
|
-
});
|
|
309
|
-
}
|
|
310
|
-
if (!Array.isArray(toolPolicy.networkAllowlist)) {
|
|
311
|
-
errors.push({
|
|
312
|
-
code: 'INVALID_TYPE',
|
|
313
|
-
field: 'toolPolicy.networkAllowlist',
|
|
314
|
-
message: 'networkAllowlist must be an array',
|
|
315
|
-
severity: 'error',
|
|
316
|
-
});
|
|
317
|
-
}
|
|
318
|
-
// Check for wildcards in network allowlist
|
|
319
|
-
const isPrivileged = Array.isArray(toolPolicy.toolsAllowed) &&
|
|
320
|
-
toolPolicy.toolsAllowed.includes('Bash');
|
|
321
|
-
if (Array.isArray(toolPolicy.networkAllowlist)) {
|
|
322
|
-
for (let i = 0; i < toolPolicy.networkAllowlist.length; i++) {
|
|
323
|
-
const entry = toolPolicy.networkAllowlist[i];
|
|
324
|
-
if (entry === '*' || entry.startsWith('*.')) {
|
|
325
|
-
if (!isPrivileged) {
|
|
326
|
-
errors.push({
|
|
327
|
-
code: 'WILDCARD_NETWORK',
|
|
328
|
-
field: `toolPolicy.networkAllowlist[${i}]`,
|
|
329
|
-
message: `Wildcard "${entry}" in network allowlist requires privileged access (Bash tool)`,
|
|
330
|
-
severity: 'error',
|
|
331
|
-
});
|
|
332
|
-
}
|
|
333
|
-
}
|
|
334
|
-
}
|
|
335
|
-
}
|
|
336
|
-
return errors;
|
|
337
|
-
}
|
|
338
|
-
/**
|
|
339
|
-
* Validate data policy fields.
|
|
340
|
-
*/
|
|
341
|
-
validateDataPolicy(dataPolicy) {
|
|
342
|
-
const errors = [];
|
|
343
|
-
if (!dataPolicy) {
|
|
344
|
-
errors.push({
|
|
345
|
-
code: 'MISSING_FIELD',
|
|
346
|
-
field: 'dataPolicy',
|
|
347
|
-
message: 'Data policy is required',
|
|
348
|
-
severity: 'error',
|
|
349
|
-
});
|
|
350
|
-
return errors;
|
|
351
|
-
}
|
|
352
|
-
if (!DATA_SENSITIVITY_LEVELS.includes(dataPolicy.dataSensitivity)) {
|
|
353
|
-
errors.push({
|
|
354
|
-
code: 'INVALID_ENUM',
|
|
355
|
-
field: 'dataPolicy.dataSensitivity',
|
|
356
|
-
message: `dataSensitivity must be one of: ${DATA_SENSITIVITY_LEVELS.join(', ')} (got "${dataPolicy.dataSensitivity}")`,
|
|
357
|
-
severity: 'error',
|
|
358
|
-
});
|
|
359
|
-
}
|
|
360
|
-
if (typeof dataPolicy.retentionDays !== 'number' || dataPolicy.retentionDays < 0) {
|
|
361
|
-
errors.push({
|
|
362
|
-
code: 'INVALID_VALUE',
|
|
363
|
-
field: 'dataPolicy.retentionDays',
|
|
364
|
-
message: 'retentionDays must be a non-negative number',
|
|
365
|
-
severity: 'error',
|
|
366
|
-
});
|
|
367
|
-
}
|
|
368
|
-
if (!dataPolicy.exportControls) {
|
|
369
|
-
errors.push({
|
|
370
|
-
code: 'MISSING_FIELD',
|
|
371
|
-
field: 'dataPolicy.exportControls',
|
|
372
|
-
message: 'exportControls is required in data policy',
|
|
373
|
-
severity: 'error',
|
|
374
|
-
});
|
|
375
|
-
}
|
|
376
|
-
else {
|
|
377
|
-
if (!Array.isArray(dataPolicy.exportControls.allowedRegions)) {
|
|
378
|
-
errors.push({
|
|
379
|
-
code: 'INVALID_TYPE',
|
|
380
|
-
field: 'dataPolicy.exportControls.allowedRegions',
|
|
381
|
-
message: 'allowedRegions must be an array',
|
|
382
|
-
severity: 'error',
|
|
383
|
-
});
|
|
384
|
-
}
|
|
385
|
-
if (!Array.isArray(dataPolicy.exportControls.blockedRegions)) {
|
|
386
|
-
errors.push({
|
|
387
|
-
code: 'INVALID_TYPE',
|
|
388
|
-
field: 'dataPolicy.exportControls.blockedRegions',
|
|
389
|
-
message: 'blockedRegions must be an array',
|
|
390
|
-
severity: 'error',
|
|
391
|
-
});
|
|
392
|
-
}
|
|
393
|
-
// Check for overlap between allowed and blocked regions
|
|
394
|
-
if (Array.isArray(dataPolicy.exportControls.allowedRegions) &&
|
|
395
|
-
Array.isArray(dataPolicy.exportControls.blockedRegions)) {
|
|
396
|
-
const overlap = dataPolicy.exportControls.allowedRegions.filter(r => dataPolicy.exportControls.blockedRegions.includes(r));
|
|
397
|
-
if (overlap.length > 0) {
|
|
398
|
-
errors.push({
|
|
399
|
-
code: 'REGION_CONFLICT',
|
|
400
|
-
field: 'dataPolicy.exportControls',
|
|
401
|
-
message: `Regions appear in both allowed and blocked lists: ${overlap.join(', ')}`,
|
|
402
|
-
severity: 'error',
|
|
403
|
-
});
|
|
404
|
-
}
|
|
405
|
-
}
|
|
406
|
-
}
|
|
407
|
-
return errors;
|
|
408
|
-
}
|
|
409
|
-
// ===== Private validation helpers =====
|
|
410
|
-
validateRequiredFields(manifest) {
|
|
411
|
-
const errors = [];
|
|
412
|
-
if (!manifest) {
|
|
413
|
-
errors.push({
|
|
414
|
-
code: 'MISSING_FIELD',
|
|
415
|
-
field: '',
|
|
416
|
-
message: 'Manifest is required',
|
|
417
|
-
severity: 'error',
|
|
418
|
-
});
|
|
419
|
-
return errors;
|
|
420
|
-
}
|
|
421
|
-
// Top-level required sections
|
|
422
|
-
const requiredSections = [
|
|
423
|
-
'apiVersion', 'cell', 'lanePolicy', 'budgets',
|
|
424
|
-
'dataPolicy', 'toolPolicy', 'memoryPolicy', 'observability',
|
|
425
|
-
];
|
|
426
|
-
for (const section of requiredSections) {
|
|
427
|
-
if (manifest[section] === undefined || manifest[section] === null) {
|
|
428
|
-
errors.push({
|
|
429
|
-
code: 'MISSING_FIELD',
|
|
430
|
-
field: section,
|
|
431
|
-
message: `Required field "${section}" is missing`,
|
|
432
|
-
severity: 'error',
|
|
433
|
-
});
|
|
434
|
-
}
|
|
435
|
-
}
|
|
436
|
-
// Cell sub-fields
|
|
437
|
-
if (manifest.cell) {
|
|
438
|
-
for (const field of ['name', 'purpose', 'ownerTenant']) {
|
|
439
|
-
if (!manifest.cell[field]) {
|
|
440
|
-
errors.push({
|
|
441
|
-
code: 'MISSING_FIELD',
|
|
442
|
-
field: `cell.${field}`,
|
|
443
|
-
message: `Required field "cell.${field}" is missing`,
|
|
444
|
-
severity: 'error',
|
|
445
|
-
});
|
|
446
|
-
}
|
|
447
|
-
}
|
|
448
|
-
if (!manifest.cell.codeRef) {
|
|
449
|
-
errors.push({
|
|
450
|
-
code: 'MISSING_FIELD',
|
|
451
|
-
field: 'cell.codeRef',
|
|
452
|
-
message: 'Required field "cell.codeRef" is missing',
|
|
453
|
-
severity: 'error',
|
|
454
|
-
});
|
|
455
|
-
}
|
|
456
|
-
else {
|
|
457
|
-
for (const field of ['kind', 'digest', 'entry']) {
|
|
458
|
-
if (!manifest.cell.codeRef[field]) {
|
|
459
|
-
errors.push({
|
|
460
|
-
code: 'MISSING_FIELD',
|
|
461
|
-
field: `cell.codeRef.${field}`,
|
|
462
|
-
message: `Required field "cell.codeRef.${field}" is missing`,
|
|
463
|
-
severity: 'error',
|
|
464
|
-
});
|
|
465
|
-
}
|
|
466
|
-
}
|
|
467
|
-
}
|
|
468
|
-
}
|
|
469
|
-
// Memory policy sub-fields
|
|
470
|
-
if (manifest.memoryPolicy) {
|
|
471
|
-
if (!manifest.memoryPolicy.namespace) {
|
|
472
|
-
errors.push({
|
|
473
|
-
code: 'MISSING_FIELD',
|
|
474
|
-
field: 'memoryPolicy.namespace',
|
|
475
|
-
message: 'Required field "memoryPolicy.namespace" is missing',
|
|
476
|
-
severity: 'error',
|
|
477
|
-
});
|
|
478
|
-
}
|
|
479
|
-
if (!AUTHORITY_SCOPES.includes(manifest.memoryPolicy.authorityScope)) {
|
|
480
|
-
errors.push({
|
|
481
|
-
code: 'INVALID_ENUM',
|
|
482
|
-
field: 'memoryPolicy.authorityScope',
|
|
483
|
-
message: `authorityScope must be one of: ${AUTHORITY_SCOPES.join(', ')}`,
|
|
484
|
-
severity: 'error',
|
|
485
|
-
});
|
|
486
|
-
}
|
|
487
|
-
if (!WRITE_MODES.includes(manifest.memoryPolicy.writeMode)) {
|
|
488
|
-
errors.push({
|
|
489
|
-
code: 'INVALID_ENUM',
|
|
490
|
-
field: 'memoryPolicy.writeMode',
|
|
491
|
-
message: `writeMode must be one of: ${WRITE_MODES.join(', ')}`,
|
|
492
|
-
severity: 'error',
|
|
493
|
-
});
|
|
494
|
-
}
|
|
495
|
-
}
|
|
496
|
-
// Observability sub-fields
|
|
497
|
-
if (manifest.observability) {
|
|
498
|
-
if (!TRACE_LEVELS.includes(manifest.observability.traceLevel)) {
|
|
499
|
-
errors.push({
|
|
500
|
-
code: 'INVALID_ENUM',
|
|
501
|
-
field: 'observability.traceLevel',
|
|
502
|
-
message: `traceLevel must be one of: ${TRACE_LEVELS.join(', ')}`,
|
|
503
|
-
severity: 'error',
|
|
504
|
-
});
|
|
505
|
-
}
|
|
506
|
-
}
|
|
507
|
-
return errors;
|
|
508
|
-
}
|
|
509
|
-
validateApiVersion(manifest) {
|
|
510
|
-
if (!manifest.apiVersion)
|
|
511
|
-
return []; // caught by requiredFields
|
|
512
|
-
if (manifest.apiVersion !== SUPPORTED_API_VERSION) {
|
|
513
|
-
return [{
|
|
514
|
-
code: 'UNSUPPORTED_API_VERSION',
|
|
515
|
-
field: 'apiVersion',
|
|
516
|
-
message: `API version "${manifest.apiVersion}" is not supported (expected "${SUPPORTED_API_VERSION}")`,
|
|
517
|
-
severity: 'error',
|
|
518
|
-
}];
|
|
519
|
-
}
|
|
520
|
-
return [];
|
|
521
|
-
}
|
|
522
|
-
validateDigest(manifest) {
|
|
523
|
-
if (!manifest.cell?.codeRef?.digest)
|
|
524
|
-
return []; // caught by requiredFields
|
|
525
|
-
if (!SHA256_DIGEST_RE.test(manifest.cell.codeRef.digest)) {
|
|
526
|
-
return [{
|
|
527
|
-
code: 'INVALID_DIGEST',
|
|
528
|
-
field: 'cell.codeRef.digest',
|
|
529
|
-
message: `Digest must match "sha256:<64 hex chars>" format (got "${manifest.cell.codeRef.digest}")`,
|
|
530
|
-
severity: 'error',
|
|
531
|
-
}];
|
|
532
|
-
}
|
|
533
|
-
return [];
|
|
534
|
-
}
|
|
535
|
-
validateWarnings(manifest) {
|
|
536
|
-
const warnings = [];
|
|
537
|
-
// Warn about unknown tools
|
|
538
|
-
if (manifest.toolPolicy?.toolsAllowed) {
|
|
539
|
-
for (const tool of manifest.toolPolicy.toolsAllowed) {
|
|
540
|
-
if (!KNOWN_TOOLS.has(tool)) {
|
|
541
|
-
warnings.push({
|
|
542
|
-
code: 'UNKNOWN_TOOL',
|
|
543
|
-
field: 'toolPolicy.toolsAllowed',
|
|
544
|
-
message: `Tool "${tool}" is not a recognized system tool`,
|
|
545
|
-
severity: 'warning',
|
|
546
|
-
});
|
|
547
|
-
}
|
|
548
|
-
}
|
|
549
|
-
}
|
|
550
|
-
// Warn if both coherence and anti-hallucination gates are disabled
|
|
551
|
-
if (manifest.memoryPolicy &&
|
|
552
|
-
!manifest.memoryPolicy.requiresCoherenceGate &&
|
|
553
|
-
!manifest.memoryPolicy.requiresAntiHallucinationGate) {
|
|
554
|
-
warnings.push({
|
|
555
|
-
code: 'NO_MEMORY_GATES',
|
|
556
|
-
field: 'memoryPolicy',
|
|
557
|
-
message: 'Both coherence and anti-hallucination gates are disabled; memory writes are ungated',
|
|
558
|
-
severity: 'warning',
|
|
559
|
-
});
|
|
560
|
-
}
|
|
561
|
-
// Warn about high retention with sensitive data
|
|
562
|
-
if (manifest.dataPolicy &&
|
|
563
|
-
manifest.dataPolicy.dataSensitivity === 'restricted' &&
|
|
564
|
-
manifest.dataPolicy.retentionDays > 30) {
|
|
565
|
-
warnings.push({
|
|
566
|
-
code: 'HIGH_RETENTION_SENSITIVE',
|
|
567
|
-
field: 'dataPolicy.retentionDays',
|
|
568
|
-
message: `Retention of ${manifest.dataPolicy.retentionDays} days is high for restricted data`,
|
|
569
|
-
severity: 'warning',
|
|
570
|
-
});
|
|
571
|
-
}
|
|
572
|
-
// Warn if no trace level is set to full but artifacts are emitted
|
|
573
|
-
if (manifest.observability &&
|
|
574
|
-
manifest.observability.emitArtifacts &&
|
|
575
|
-
manifest.observability.traceLevel === 'none') {
|
|
576
|
-
warnings.push({
|
|
577
|
-
code: 'ARTIFACTS_WITHOUT_TRACING',
|
|
578
|
-
field: 'observability',
|
|
579
|
-
message: 'Artifact emission is enabled but trace level is "none"',
|
|
580
|
-
severity: 'warning',
|
|
581
|
-
});
|
|
582
|
-
}
|
|
583
|
-
return warnings;
|
|
584
|
-
}
|
|
585
|
-
}
|
|
586
|
-
// ============================================================================
|
|
587
|
-
// ConformanceSuite
|
|
588
|
-
// ============================================================================
|
|
589
|
-
/**
|
|
590
|
-
* Runs golden traces through an evaluator and reports conformance.
|
|
591
|
-
*
|
|
592
|
-
* Each trace contains events with expected outcomes. The suite feeds every
|
|
593
|
-
* event to the evaluator and compares the actual decision to the expectation.
|
|
594
|
-
*/
|
|
595
|
-
export class ConformanceSuite {
|
|
596
|
-
traces = [];
|
|
597
|
-
/**
|
|
598
|
-
* Add a golden trace to the suite.
|
|
599
|
-
*/
|
|
600
|
-
addTrace(trace) {
|
|
601
|
-
this.traces.push(trace);
|
|
602
|
-
}
|
|
603
|
-
/**
|
|
604
|
-
* Run every event in every trace through the evaluator and compare
|
|
605
|
-
* actual decisions against expected outcomes.
|
|
606
|
-
*/
|
|
607
|
-
run(evaluator) {
|
|
608
|
-
let totalEvents = 0;
|
|
609
|
-
let matchedEvents = 0;
|
|
610
|
-
const mismatches = [];
|
|
611
|
-
for (const trace of this.traces) {
|
|
612
|
-
for (const event of trace.events) {
|
|
613
|
-
totalEvents++;
|
|
614
|
-
const { decision, details } = evaluator(event);
|
|
615
|
-
const expected = trace.expectedDecisions[String(event.seq)] ?? event.expectedOutcome;
|
|
616
|
-
if (decision === expected) {
|
|
617
|
-
matchedEvents++;
|
|
618
|
-
}
|
|
619
|
-
else {
|
|
620
|
-
mismatches.push({
|
|
621
|
-
traceId: trace.traceId,
|
|
622
|
-
seq: event.seq,
|
|
623
|
-
expected,
|
|
624
|
-
actual: decision,
|
|
625
|
-
details,
|
|
626
|
-
});
|
|
627
|
-
}
|
|
628
|
-
}
|
|
629
|
-
}
|
|
630
|
-
return {
|
|
631
|
-
passed: mismatches.length === 0,
|
|
632
|
-
totalEvents,
|
|
633
|
-
matchedEvents,
|
|
634
|
-
mismatches,
|
|
635
|
-
};
|
|
636
|
-
}
|
|
637
|
-
/**
|
|
638
|
-
* Get all registered traces.
|
|
639
|
-
*/
|
|
640
|
-
getTraces() {
|
|
641
|
-
return [...this.traces];
|
|
642
|
-
}
|
|
643
|
-
/**
|
|
644
|
-
* Create built-in default golden traces that verify core platform invariants:
|
|
645
|
-
*
|
|
646
|
-
* 1. Destructive command blocked
|
|
647
|
-
* 2. Secret detected and blocked
|
|
648
|
-
* 3. Budget exceeded and denied
|
|
649
|
-
* 4. Memory write without evidence blocked
|
|
650
|
-
* 5. Valid operation allowed
|
|
651
|
-
*/
|
|
652
|
-
createDefaultTraces() {
|
|
653
|
-
const traces = [
|
|
654
|
-
// Trace 1: Destructive command must be blocked
|
|
655
|
-
{
|
|
656
|
-
traceId: 'default-destructive-blocked',
|
|
657
|
-
name: 'Destructive command blocked',
|
|
658
|
-
description: 'Verifies that destructive commands (rm -rf, DROP TABLE) are denied',
|
|
659
|
-
events: [
|
|
660
|
-
{
|
|
661
|
-
seq: 1,
|
|
662
|
-
eventType: 'command',
|
|
663
|
-
payload: { command: 'rm -rf /', tool: 'Bash' },
|
|
664
|
-
expectedOutcome: 'deny',
|
|
665
|
-
},
|
|
666
|
-
{
|
|
667
|
-
seq: 2,
|
|
668
|
-
eventType: 'command',
|
|
669
|
-
payload: { command: 'DROP TABLE users', tool: 'Bash' },
|
|
670
|
-
expectedOutcome: 'deny',
|
|
671
|
-
},
|
|
672
|
-
{
|
|
673
|
-
seq: 3,
|
|
674
|
-
eventType: 'command',
|
|
675
|
-
payload: { command: 'git push --force origin main', tool: 'Bash' },
|
|
676
|
-
expectedOutcome: 'deny',
|
|
677
|
-
},
|
|
678
|
-
],
|
|
679
|
-
expectedDecisions: { '1': 'deny', '2': 'deny', '3': 'deny' },
|
|
680
|
-
expectedMemoryLineage: {},
|
|
681
|
-
},
|
|
682
|
-
// Trace 2: Secret detected and blocked
|
|
683
|
-
{
|
|
684
|
-
traceId: 'default-secret-blocked',
|
|
685
|
-
name: 'Secret detected and blocked',
|
|
686
|
-
description: 'Verifies that secrets in tool parameters are detected and blocked',
|
|
687
|
-
events: [
|
|
688
|
-
{
|
|
689
|
-
seq: 1,
|
|
690
|
-
eventType: 'tool-use',
|
|
691
|
-
payload: {
|
|
692
|
-
tool: 'Write',
|
|
693
|
-
params: { content: 'api_key = "sk-abc123456789012345678901234567890"' },
|
|
694
|
-
},
|
|
695
|
-
expectedOutcome: 'deny',
|
|
696
|
-
},
|
|
697
|
-
{
|
|
698
|
-
seq: 2,
|
|
699
|
-
eventType: 'tool-use',
|
|
700
|
-
payload: {
|
|
701
|
-
tool: 'Edit',
|
|
702
|
-
params: { content: '-----BEGIN RSA PRIVATE KEY-----' },
|
|
703
|
-
},
|
|
704
|
-
expectedOutcome: 'deny',
|
|
705
|
-
},
|
|
706
|
-
],
|
|
707
|
-
expectedDecisions: { '1': 'deny', '2': 'deny' },
|
|
708
|
-
expectedMemoryLineage: {},
|
|
709
|
-
},
|
|
710
|
-
// Trace 3: Budget exceeded and denied
|
|
711
|
-
{
|
|
712
|
-
traceId: 'default-budget-exceeded',
|
|
713
|
-
name: 'Budget exceeded and denied',
|
|
714
|
-
description: 'Verifies that operations exceeding budget limits are denied',
|
|
715
|
-
events: [
|
|
716
|
-
{
|
|
717
|
-
seq: 1,
|
|
718
|
-
eventType: 'budget-check',
|
|
719
|
-
payload: {
|
|
720
|
-
resource: 'toolCalls',
|
|
721
|
-
current: 999,
|
|
722
|
-
limit: 1000,
|
|
723
|
-
requested: 5,
|
|
724
|
-
},
|
|
725
|
-
expectedOutcome: 'deny',
|
|
726
|
-
},
|
|
727
|
-
{
|
|
728
|
-
seq: 2,
|
|
729
|
-
eventType: 'budget-check',
|
|
730
|
-
payload: {
|
|
731
|
-
resource: 'wallClockSeconds',
|
|
732
|
-
current: 3500,
|
|
733
|
-
limit: 3600,
|
|
734
|
-
requested: 200,
|
|
735
|
-
},
|
|
736
|
-
expectedOutcome: 'deny',
|
|
737
|
-
},
|
|
738
|
-
],
|
|
739
|
-
expectedDecisions: { '1': 'deny', '2': 'deny' },
|
|
740
|
-
expectedMemoryLineage: {},
|
|
741
|
-
},
|
|
742
|
-
// Trace 4: Memory write without evidence blocked
|
|
743
|
-
{
|
|
744
|
-
traceId: 'default-memory-no-evidence',
|
|
745
|
-
name: 'Memory write without evidence blocked',
|
|
746
|
-
description: 'Verifies that memory writes without proof/evidence trail are denied',
|
|
747
|
-
events: [
|
|
748
|
-
{
|
|
749
|
-
seq: 1,
|
|
750
|
-
eventType: 'memory-write',
|
|
751
|
-
payload: {
|
|
752
|
-
key: 'critical-decision',
|
|
753
|
-
namespace: 'coordination',
|
|
754
|
-
hasEvidence: false,
|
|
755
|
-
coherenceScore: 0.3,
|
|
756
|
-
},
|
|
757
|
-
expectedOutcome: 'deny',
|
|
758
|
-
},
|
|
759
|
-
{
|
|
760
|
-
seq: 2,
|
|
761
|
-
eventType: 'memory-write',
|
|
762
|
-
payload: {
|
|
763
|
-
key: 'hallucinated-data',
|
|
764
|
-
namespace: 'facts',
|
|
765
|
-
hasEvidence: false,
|
|
766
|
-
antiHallucinationPassed: false,
|
|
767
|
-
},
|
|
768
|
-
expectedOutcome: 'deny',
|
|
769
|
-
},
|
|
770
|
-
],
|
|
771
|
-
expectedDecisions: { '1': 'deny', '2': 'deny' },
|
|
772
|
-
expectedMemoryLineage: {
|
|
773
|
-
'critical-decision': ['initial-assessment', 'root-task'],
|
|
774
|
-
},
|
|
775
|
-
},
|
|
776
|
-
// Trace 5: Valid operation allowed
|
|
777
|
-
{
|
|
778
|
-
traceId: 'default-valid-allowed',
|
|
779
|
-
name: 'Valid operation allowed',
|
|
780
|
-
description: 'Verifies that well-formed, safe operations are allowed through',
|
|
781
|
-
events: [
|
|
782
|
-
{
|
|
783
|
-
seq: 1,
|
|
784
|
-
eventType: 'command',
|
|
785
|
-
payload: { command: 'git status', tool: 'Bash' },
|
|
786
|
-
expectedOutcome: 'allow',
|
|
787
|
-
},
|
|
788
|
-
{
|
|
789
|
-
seq: 2,
|
|
790
|
-
eventType: 'tool-use',
|
|
791
|
-
payload: {
|
|
792
|
-
tool: 'Read',
|
|
793
|
-
params: { file_path: '/home/user/project/src/index.ts' },
|
|
794
|
-
},
|
|
795
|
-
expectedOutcome: 'allow',
|
|
796
|
-
},
|
|
797
|
-
{
|
|
798
|
-
seq: 3,
|
|
799
|
-
eventType: 'memory-write',
|
|
800
|
-
payload: {
|
|
801
|
-
key: 'agent-status',
|
|
802
|
-
namespace: 'coordination',
|
|
803
|
-
hasEvidence: true,
|
|
804
|
-
coherenceScore: 0.95,
|
|
805
|
-
antiHallucinationPassed: true,
|
|
806
|
-
},
|
|
807
|
-
expectedOutcome: 'allow',
|
|
808
|
-
},
|
|
809
|
-
],
|
|
810
|
-
expectedDecisions: { '1': 'allow', '2': 'allow', '3': 'allow' },
|
|
811
|
-
expectedMemoryLineage: {},
|
|
812
|
-
},
|
|
813
|
-
];
|
|
814
|
-
return traces;
|
|
815
|
-
}
|
|
816
|
-
}
|
|
817
|
-
// ============================================================================
|
|
818
|
-
// Factory Functions
|
|
819
|
-
// ============================================================================
|
|
820
|
-
/**
|
|
821
|
-
* Create a new ManifestValidator instance.
|
|
822
|
-
*/
|
|
823
|
-
export function createManifestValidator(options) {
|
|
824
|
-
return new ManifestValidator(options);
|
|
825
|
-
}
|
|
826
|
-
/**
|
|
827
|
-
* Create a new ConformanceSuite instance, optionally pre-loaded with default traces.
|
|
828
|
-
*/
|
|
829
|
-
export function createConformanceSuite(options) {
|
|
830
|
-
const suite = new ConformanceSuite();
|
|
831
|
-
if (options?.includeDefaults) {
|
|
832
|
-
for (const trace of suite.createDefaultTraces()) {
|
|
833
|
-
suite.addTrace(trace);
|
|
834
|
-
}
|
|
835
|
-
}
|
|
836
|
-
return suite;
|
|
837
|
-
}
|
|
838
|
-
//# sourceMappingURL=manifest-validator.js.map
|