ai-forge-cli 0.1.3__tar.gz → 0.1.4__tar.gz
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.
- {ai_forge_cli-0.1.3/src/ai_forge_cli.egg-info → ai_forge_cli-0.1.4}/PKG-INFO +1 -1
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/README.md +9 -5
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/pyproject.toml +1 -1
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4/src/ai_forge_cli.egg-info}/PKG-INFO +1 -1
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/__init__.py +1 -1
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/commands/init.py +3 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/tests/test_cli.py +2 -2
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/tests/test_init.py +2 -2
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/LICENSE +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/setup.cfg +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/ai_forge_cli.egg-info/SOURCES.txt +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/ai_forge_cli.egg-info/dependency_links.txt +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/ai_forge_cli.egg-info/entry_points.txt +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/ai_forge_cli.egg-info/requires.txt +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/ai_forge_cli.egg-info/top_level.txt +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/__main__.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/bundle.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/commands/__init__.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/commands/base.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/commands/context.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/commands/find.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/commands/inspect.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/commands/list_cmd.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/commands/update.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/common.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/forge.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/index.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/src/cli/walker.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/tests/test_find.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/tests/test_index.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/tests/test_update.py +0 -0
- {ai_forge_cli-0.1.3 → ai_forge_cli-0.1.4}/tests/test_walker.py +0 -0
|
@@ -21,7 +21,7 @@ The agent drives the interview. The specs drive the code.
|
|
|
21
21
|
|
|
22
22
|
## What it is
|
|
23
23
|
|
|
24
|
-
A six-layer YAML spec system, a Python CLI for context assembly, and **
|
|
24
|
+
A six-layer YAML spec system, a Python CLI for context assembly, and **eleven agent skills** that take a human from a vague product idea to working, audited, hardened, validated code — with the agent asking questions and the human answering, not the reverse.
|
|
25
25
|
|
|
26
26
|
Built on the premise that **people explain systems well under questioning but poorly when cold-prompted**. forge inverts the default "human prompts agent → agent implements" loop into "agent interviews human → structured spec emerges → agent implements from spec".
|
|
27
27
|
|
|
@@ -42,6 +42,8 @@ Runs in **Claude Code**, **OpenAI Codex CLI**, and any **agentskills.io-compatib
|
|
|
42
42
|
↓
|
|
43
43
|
forge-compose → L4 composition (flows + journeys from completed atoms)
|
|
44
44
|
↓
|
|
45
|
+
forge-cast → repo hydration (existing codebase → draft Forge corpus + uncertainty report)
|
|
46
|
+
↓
|
|
45
47
|
forge-audit → quality gate (seven audit passes, severity-ranked findings)
|
|
46
48
|
↓
|
|
47
49
|
forge-armour → security hardening (trust model, policies, abuse-case review)
|
|
@@ -68,7 +70,7 @@ uv venv --python 3.13 .venv && uv pip install -e . pytest
|
|
|
68
70
|
./scripts/install-skills.sh install
|
|
69
71
|
```
|
|
70
72
|
|
|
71
|
-
This wires the `forge` binary into `~/.local/bin/` and symlinks the
|
|
73
|
+
This wires the `forge` binary into `~/.local/bin/` and symlinks the eleven skills into `~/.claude/skills/`, `~/.codex/skills/`, and `~/.agents/skills/` — discoverable by every supported client.
|
|
72
74
|
|
|
73
75
|
### Verify
|
|
74
76
|
|
|
@@ -110,7 +112,7 @@ forge init
|
|
|
110
112
|
✓ .forge/
|
|
111
113
|
✓ 6 spec subdirectories
|
|
112
114
|
✓ 12 schema templates → .forge/templates/
|
|
113
|
-
✓
|
|
115
|
+
✓ 33/33 skill symlinks → .claude/skills/, .codex/skills/, .agents/skills/
|
|
114
116
|
|
|
115
117
|
───── Next steps ─────
|
|
116
118
|
|
|
@@ -149,7 +151,7 @@ Full CLI guide: [`docs/cli-guide.md`](docs/cli-guide.md).
|
|
|
149
151
|
|
|
150
152
|
---
|
|
151
153
|
|
|
152
|
-
## The
|
|
154
|
+
## The eleven skills
|
|
153
155
|
|
|
154
156
|
| Skill | Role | Input | Output |
|
|
155
157
|
|---|---|---|---|
|
|
@@ -157,6 +159,7 @@ Full CLI guide: [`docs/cli-guide.md`](docs/cli-guide.md).
|
|
|
157
159
|
| **forge-decompose** | Structural extractor | One bounded module | Exhaustive atom stubs (four-pass extraction) |
|
|
158
160
|
| **forge-atom** | Contract specifier | One atom stub | Complete L3 spec + L0 cascades + module completions |
|
|
159
161
|
| **forge-compose** | Composition specifier | Completed atoms + project decisions | L4 flow/journey specs with explicit boundary/retry/compensation/idempotency decisions |
|
|
162
|
+
| **forge-cast** | Hydration specifier | Existing non-Forge codebase | Draft Forge corpus plus evidence-backed uncertainty report and clarification questions |
|
|
160
163
|
| **forge-audit** | Challenger / reviewer | Completed specs | Severity-ranked findings with inline edits; seven audit passes |
|
|
161
164
|
| **forge-armour** | Security challenger | Audited specs | Security hardening pass, trust-model capture, approved project/module/atom security edits |
|
|
162
165
|
| **forge-implement** | Orchestrator | Audited spec corpus | Code + tests, dep-graph parallel, test-before-impl isolation |
|
|
@@ -196,11 +199,12 @@ forge/
|
|
|
196
199
|
│ ├── cli/ Python CLI package (the forge command)
|
|
197
200
|
│ ├── templates/ L0-L5 schema templates (symlinked into projects by forge init)
|
|
198
201
|
│ └── example/ Working example spec corpus (used by tests)
|
|
199
|
-
├── .agents/skills/ The
|
|
202
|
+
├── .agents/skills/ The 11 forge skills (installed into agent clients)
|
|
200
203
|
│ ├── forge-discover/
|
|
201
204
|
│ ├── forge-decompose/
|
|
202
205
|
│ ├── forge-atom/
|
|
203
206
|
│ ├── forge-compose/
|
|
207
|
+
│ ├── forge-cast/
|
|
204
208
|
│ ├── forge-audit/
|
|
205
209
|
│ ├── forge-armour/
|
|
206
210
|
│ ├── forge-implement/
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
"""Forge CLI — context walker for the L0-L5 spec system."""
|
|
2
|
-
__version__ = "0.1.
|
|
2
|
+
__version__ = "0.1.4"
|
|
@@ -125,6 +125,7 @@ SKILL_NAMES = (
|
|
|
125
125
|
"forge-decompose",
|
|
126
126
|
"forge-atom",
|
|
127
127
|
"forge-compose",
|
|
128
|
+
"forge-cast",
|
|
128
129
|
"forge-audit",
|
|
129
130
|
"forge-armour",
|
|
130
131
|
"forge-implement",
|
|
@@ -341,6 +342,7 @@ def run(args: argparse.Namespace) -> int:
|
|
|
341
342
|
print(f" {_bold('\"I want to build a tool that does X\"')}")
|
|
342
343
|
print(f" {_bold('\"Decompose the PAY module into atoms\"')}")
|
|
343
344
|
print(f" {_bold('\"Compose flows and journeys from completed atoms\"')}")
|
|
345
|
+
print(f" {_bold('\"Cast this existing repo into Forge docs\"')}")
|
|
344
346
|
print(f" {_bold('\"Audit the specs before implementation\"')}")
|
|
345
347
|
print(f" {_bold('\"Harden the specs for security before implementation\"')}")
|
|
346
348
|
print(f" {_bold('\"Validate the implementation against specs\"')}")
|
|
@@ -350,6 +352,7 @@ def run(args: argparse.Namespace) -> int:
|
|
|
350
352
|
+ _color(_FIRE_PRIMARY, "/forge-decompose") + " "
|
|
351
353
|
+ _color(_FIRE_PRIMARY, "/forge-atom") + " "
|
|
352
354
|
+ _color(_FIRE_PRIMARY, "/forge-compose") + " "
|
|
355
|
+
+ _color(_FIRE_PRIMARY, "/forge-cast") + " "
|
|
353
356
|
+ _color(_FIRE_PRIMARY, "/forge-audit") + " "
|
|
354
357
|
+ _color(_FIRE_PRIMARY, "/forge-armour") + " "
|
|
355
358
|
+ _color(_FIRE_PRIMARY, "/forge-implement") + " "
|
|
@@ -32,7 +32,7 @@ def test_version_flag_prints_version_and_exits_0():
|
|
|
32
32
|
|
|
33
33
|
def test_version_string_prefers_ai_forge_cli_distribution(monkeypatch):
|
|
34
34
|
versions = {
|
|
35
|
-
"ai-forge-cli": "0.1.
|
|
35
|
+
"ai-forge-cli": "0.1.4",
|
|
36
36
|
"forge-ai-cli": "0.1.1",
|
|
37
37
|
}
|
|
38
38
|
|
|
@@ -42,7 +42,7 @@ def test_version_string_prefers_ai_forge_cli_distribution(monkeypatch):
|
|
|
42
42
|
raise metadata.PackageNotFoundError
|
|
43
43
|
|
|
44
44
|
monkeypatch.setattr(forge_mod.metadata, "version", fake_version)
|
|
45
|
-
assert forge_mod._version_string() == "0.1.
|
|
45
|
+
assert forge_mod._version_string() == "0.1.4"
|
|
46
46
|
|
|
47
47
|
|
|
48
48
|
# ---------- context ----------
|
|
@@ -143,7 +143,7 @@ def test_resolve_forge_sources_uses_cached_repo_when_local_skills_missing(monkey
|
|
|
143
143
|
|
|
144
144
|
def test_installed_cli_version_prefers_ai_forge_cli_distribution(monkeypatch):
|
|
145
145
|
versions = {
|
|
146
|
-
"ai-forge-cli": "0.1.
|
|
146
|
+
"ai-forge-cli": "0.1.4",
|
|
147
147
|
"forge-ai-cli": "0.1.1",
|
|
148
148
|
}
|
|
149
149
|
|
|
@@ -153,4 +153,4 @@ def test_installed_cli_version_prefers_ai_forge_cli_distribution(monkeypatch):
|
|
|
153
153
|
raise init_cmd.metadata.PackageNotFoundError
|
|
154
154
|
|
|
155
155
|
monkeypatch.setattr(init_cmd.metadata, "version", fake_version)
|
|
156
|
-
assert init_cmd._installed_cli_version() == "0.1.
|
|
156
|
+
assert init_cmd._installed_cli_version() == "0.1.4"
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|