safe-ai-factory 0.0.1
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/LICENSE +21 -0
- package/README.md +152 -0
- package/dist/chunk-4Z75XWCR.js +7824 -0
- package/dist/chunk-4Z75XWCR.js.map +1 -0
- package/dist/cli.d.ts +4 -0
- package/dist/cli.js +8 -0
- package/dist/cli.js.map +1 -0
- package/dist/index.d.ts +534 -0
- package/dist/index.js +7 -0
- package/dist/index.js.map +1 -0
- package/package.json +145 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 JuroOravec
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
# SAIFAC: Safety harness for autonomous AI agents
|
|
2
|
+
|
|
3
|
+
[](https://safeaifactory.com)
|
|
4
|
+
[](https://github.com/JuroOravec/safe-ai-factory/blob/main/LICENSE)
|
|
5
|
+
[](https://www.npmjs.com/package/safe-ai-factory)
|
|
6
|
+
[](https://www.npmjs.com/package/safe-ai-factory)
|
|
7
|
+
[](https://github.com/JuroOravec/safe-ai-factory)
|
|
8
|
+
|
|
9
|
+
**Spec-driven AI factory. Use with any agentic CLI. Language-agnostic. Safe by design.**
|
|
10
|
+
|
|
11
|
+
_Like [GasTown](https://github.com/steveyegge/gastown), but agents can't cheat, leak, wreak havoc._
|
|
12
|
+
|
|
13
|
+
Full feature preview at:
|
|
14
|
+
|
|
15
|
+
[](https://safeaifactory.com)
|
|
16
|
+
|
|
17
|
+
> ⚠️ **Status: Alpha.** SAIFAC is under active development. See the [Roadmap](https://github.com/users/JuroOravec/projects/3) for what's coming next.
|
|
18
|
+
>
|
|
19
|
+
> _[**Sponsor this project**](https://github.com/sponsors/JuroOravec)_
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Stop Coding. Start Spec'ing.
|
|
24
|
+
|
|
25
|
+
**`safe-ai-factory` implements state-of-the-art (early 2026) architecture for Agentic engineering.**
|
|
26
|
+
|
|
27
|
+
**SAIFAC Guarantee:**
|
|
28
|
+
|
|
29
|
+
- **The AI builds _exactly_ what you asked for.**
|
|
30
|
+
- The agent is locked in a loop and physically cannot stop until your new TDD tests pass.
|
|
31
|
+
- **The AI can't break previously-built features.**
|
|
32
|
+
- All features built with SAIFAC are protected by tests. AI can't break or change them. Regressions are mechanically impossible.
|
|
33
|
+
- **The AI breaks _nothing_ on your machine.**
|
|
34
|
+
- The agent runs in a zero-trust, sandboxed Docker environment. Your existing codebase is safe.
|
|
35
|
+
|
|
36
|
+
Read more on [Security & Isolation](./docs/security.md).
|
|
37
|
+
|
|
38
|
+
## The Gauntlet: Merge with Confidence
|
|
39
|
+
|
|
40
|
+
The AI agent is trapped in a rigorous convergence loop. Every time it writes code, it must survive three stages before opening a PR:
|
|
41
|
+
|
|
42
|
+
1. **The Gate:** Your linters, type-checkers, and other static analysis tools.
|
|
43
|
+
2. **The Reviewer:** Adversarial AI that scrutinizes the diff to ensure it matches the spec without taking shortcuts.
|
|
44
|
+
3. **Holdout Tests:** Hidden tests. Agent can't see them. Can't fake a pass.
|
|
45
|
+
|
|
46
|
+
You only get notified when the code emerges victorious.
|
|
47
|
+
|
|
48
|
+
## Batteries-Included
|
|
49
|
+
|
|
50
|
+
SAIFAC supports out of the box:
|
|
51
|
+
|
|
52
|
+
- All major LLM providers + OpenRouter + OpenAI-compatible APIs
|
|
53
|
+
- 14 Agentic CLI tools
|
|
54
|
+
- 4 Programming languages (Node.js, Python, Go, Rust)
|
|
55
|
+
- All major Git providers
|
|
56
|
+
|
|
57
|
+
## Deployment
|
|
58
|
+
|
|
59
|
+
SAIFAC runs as a CLI that spins up coding agents in ephemeral Docker containers on your machine. Self-hosted and Kubernetes (Helm) deployment support is underway.
|
|
60
|
+
|
|
61
|
+
<youtube video>
|
|
62
|
+
|
|
63
|
+
## Try it out now
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
pnpm install -g safe-ai-factory
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Usage:
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
# 0. Set an API key
|
|
73
|
+
export ANTHROPIC_API_KEY=sk-ant-...
|
|
74
|
+
|
|
75
|
+
# 1. One-time setup
|
|
76
|
+
saifac init
|
|
77
|
+
|
|
78
|
+
# 2. Scaffold proposal.md and edit it
|
|
79
|
+
saifac feat new -n add-login
|
|
80
|
+
|
|
81
|
+
# 3. Generate specs and tests
|
|
82
|
+
saifac feat design -n add-login
|
|
83
|
+
|
|
84
|
+
# 4. Run coding agent in sandbox
|
|
85
|
+
# until tests pass
|
|
86
|
+
saifac feat run -n add-login
|
|
87
|
+
|
|
88
|
+
# Use different agent and create a PR when done.
|
|
89
|
+
saifac feat run -n add-login --agent aider --push origin --pr
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Step-by-step guide
|
|
93
|
+
|
|
94
|
+
See the [Step-by-step guide](docs/usage.md) for a detailed walkthrough of the workflow.
|
|
95
|
+
|
|
96
|
+
## VSCode extension
|
|
97
|
+
|
|
98
|
+
The SAIFAC VSCode extension provides a dedicated sidebar panel to manage your entire AI engineering workflow directly from your editor.
|
|
99
|
+
|
|
100
|
+
**What the extension does:**
|
|
101
|
+
|
|
102
|
+
- **Manage Features:** Visual tree view of your features. Create new features, or manage existing ones through GUI.
|
|
103
|
+
- **Design & Run:** One-click actions to generate specs (`saifac feat design`), start the coding swarm (`saifac feat run`), or drop into a debug container (`saifac feat debug`).
|
|
104
|
+
- **Track Runs:** A Kubernetes-style dashboard of all your agent runs. See status (success/failed), view run configs, and instantly resume failed runs or clear old ones.
|
|
105
|
+
|
|
106
|
+
<!-- TODO - LINK TO MARKETPLACE -->
|
|
107
|
+
<!-- TODO - EMBED VIDEO OR SCREENSHOT OF THE SIDEBAR (e.g. workspace.png or runs.png) -->
|
|
108
|
+
|
|
109
|
+
## Requirements
|
|
110
|
+
|
|
111
|
+
- Node.js 22+
|
|
112
|
+
- Python 3.12+
|
|
113
|
+
- Docker
|
|
114
|
+
- Git
|
|
115
|
+
- LLM API key
|
|
116
|
+
- Linux or MacOS (Windows is not supported yet)
|
|
117
|
+
|
|
118
|
+
## A fully customizable factory
|
|
119
|
+
|
|
120
|
+
Every component of SAIFAC is fully modular. You can swap, customize, or disable to fit your team's needs:
|
|
121
|
+
|
|
122
|
+
- Want to use a different LLMs for coding and designing agents? Easy.
|
|
123
|
+
- Want to use your custom Playwright setup for testing? Done.
|
|
124
|
+
- Need to enforce strict filesystem rules? It's built in.
|
|
125
|
+
|
|
126
|
+
Dive into the details of what you can customize in the [Features guide](./docs/features.md).
|
|
127
|
+
|
|
128
|
+
## Reference
|
|
129
|
+
|
|
130
|
+
- [Usage](./docs/usage.md)
|
|
131
|
+
- [Configuration](./docs/config.md)
|
|
132
|
+
- [Spec-driven development](./docs/spec-driven-development.md) <!-- TODO -->
|
|
133
|
+
- [Agents](docs/agents/README.md)
|
|
134
|
+
- [Security & Isolation](./docs/security.md)
|
|
135
|
+
- [Access control with Cedar](./docs/cedar-access-control.md)
|
|
136
|
+
- [Environments and Infrastructure](./docs/services.md)
|
|
137
|
+
- [Sandbox profiles](./docs/sandbox-profiles.md)
|
|
138
|
+
- [Test profiles](./docs/test-profiles.md)
|
|
139
|
+
- [Semantic reviewer](./docs/reviewer.md)
|
|
140
|
+
- [Spec designers](./docs/designers/README.md)
|
|
141
|
+
- [Codebase indexers](./docs/indexer/README.md)
|
|
142
|
+
- [Source control integrations](docs/source-control.md)
|
|
143
|
+
- [Commands](docs/commands/README.md)
|
|
144
|
+
- [Environment variable](docs/env-vars.md)
|
|
145
|
+
|
|
146
|
+
## Development
|
|
147
|
+
|
|
148
|
+
See our [Development guide](docs/development.md)
|
|
149
|
+
|
|
150
|
+
## License
|
|
151
|
+
|
|
152
|
+
MIT
|