1  ;; SPDX-License-Identifier: AGPL-3.0-or-later
 2  ;; SPDX-FileCopyrightText: 2025 Jonathan D.A. Jewell
 3  ;; AGENTIC.scm — deno-bunbridge
 4  
 5  (define-module (deno-bunbridge agentic)
 6    #:export (agent-capabilities autonomy-levels decision-boundaries))
 7  
 8  (define agent-capabilities
 9    '((api-implementation
10       (description . "Agent can implement Bun API equivalents in Deno")
11       (scope . ("Read Bun documentation" "Create TypeScript interfaces" "Implement using Deno APIs"))
12       (limitations . ("Cannot access Bun source code" "Must maintain API compatibility")))
13  
14      (test-generation
15       (description . "Agent can generate tests for API compatibility")
16       (scope . ("Create Deno.test cases" "Compare behavior with Bun" "Generate edge case tests"))
17       (limitations . ("Cannot run tests on actual Bun" "Behavior documented may differ")))
18  
19      (documentation
20       (description . "Agent can maintain documentation")
21       (scope . ("Update README" "Generate API docs" "Write migration guides"))
22       (limitations . ("Cannot publish externally" "Human review required")))
23  
24      (dependency-analysis
25       (description . "Agent can analyze and suggest dependency updates")
26       (scope . ("Check for updates" "Analyze compatibility" "Suggest upgrades"))
27       (limitations . ("Cannot automatically upgrade" "Security review required")))))
28  
29  (define autonomy-levels
30    '((level-1-autonomous
31       (actions . ("Format code" "Run linters" "Generate type definitions" "Update imports"))
32       (approval . "none"))
33  
34      (level-2-supervised
35       (actions . ("Implement new APIs" "Refactor modules" "Add tests" "Update docs"))
36       (approval . "human-review"))
37  
38      (level-3-restricted
39       (actions . ("Modify public API" "Change FFI bindings" "Update dependencies"))
40       (approval . "explicit-request"))
41  
42      (level-4-prohibited
43       (actions . ("Publish packages" "Delete files" "Modify security configs"))
44       (approval . "never-autonomous"))))
45  
46  (define decision-boundaries
47    '((technical-decisions
48       (agent-decides . ("Implementation details" "Test structure" "Internal naming"))
49       (human-decides . ("Public API design" "Breaking changes" "Dependency choices")))
50  
51      (quality-decisions
52       (agent-decides . ("Code formatting" "Linting fixes" "Documentation updates"))
53       (human-decides . ("Architecture changes" "Performance tradeoffs" "Feature scope")))
54  
55      (security-decisions
56       (agent-decides . ("Adding null checks" "Input validation patterns"))
57       (human-decides . ("FFI safety boundaries" "Permission requirements" "Credential handling")))))