geloforge 0.0.0-stage → 0.7.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/LICENSE +21 -0
- package/README.md +72 -2
- package/THIRD_PARTY_NOTICES.md +33 -0
- package/VERSION +1 -0
- package/adapters/n8n/staging-audit-error-workflow.json +132 -0
- package/core/adopt-project.mjs +458 -0
- package/core/audit-learning.mjs +68 -0
- package/core/audit-provider.mjs +88 -0
- package/core/autonomous-audit.mjs +214 -0
- package/core/checkpoint.mjs +448 -0
- package/core/codebase-map.mjs +886 -0
- package/core/compatibility.json +16 -0
- package/core/compatibility.mjs +123 -0
- package/core/context-cache.mjs +113 -0
- package/core/context-compiler.mjs +1315 -0
- package/core/evidence-capture.mjs +347 -0
- package/core/git-utils.mjs +167 -0
- package/core/handoff.mjs +815 -0
- package/core/json-schema-lite.mjs +119 -0
- package/core/mcp-init.mjs +251 -0
- package/core/mcp-server.mjs +915 -0
- package/core/operation-approval.mjs +102 -0
- package/core/path-safety.mjs +508 -0
- package/core/project-locator.mjs +231 -0
- package/core/project-lock.mjs +438 -0
- package/core/project-status.mjs +635 -0
- package/core/project-validator.mjs +544 -0
- package/core/promotion.mjs +90 -0
- package/core/runtime-files.mjs +40 -0
- package/core/skills-history.mjs +572 -0
- package/core/skills-lifecycle.mjs +2225 -0
- package/core/skills-lint.mjs +365 -0
- package/core/skills.mjs +1449 -0
- package/core/staging-audit.mjs +454 -0
- package/core/staging-evidence.mjs +127 -0
- package/core/task-manager.mjs +1044 -0
- package/core/template-utils.mjs +190 -0
- package/core/text-utils.mjs +48 -0
- package/core/verify-task.mjs +48 -0
- package/core/worktrees.mjs +64 -0
- package/core/yaml-subset.mjs +572 -0
- package/package.json +50 -4
- package/policies/approval-boundaries.md +42 -0
- package/policies/memory-policy.md +53 -0
- package/policies/token-efficiency.md +30 -0
- package/schemas/README.md +43 -0
- package/schemas/adr.schema.json +64 -0
- package/schemas/agent-handoff.schema.json +139 -0
- package/schemas/approval-record.schema.json +110 -0
- package/schemas/conflict-record.schema.json +60 -0
- package/schemas/context-pack-manifest.schema.json +194 -0
- package/schemas/evidence-manifest.schema.json +83 -0
- package/schemas/incident-record.schema.json +53 -0
- package/schemas/project-manifest.schema.json +90 -0
- package/schemas/project-state.schema.json +64 -0
- package/schemas/recovery-checkpoint.schema.json +49 -0
- package/schemas/research-record.schema.json +76 -0
- package/schemas/task-contract.schema.json +95 -0
- package/scripts/bootstrap-project.mjs +357 -0
- package/scripts/geloforge.mjs +2512 -0
- package/templates/profiles/README.md +19 -0
- package/templates/profiles/ai-system/brain/profile.md +21 -0
- package/templates/profiles/ai-system/gitignore.append +5 -0
- package/templates/profiles/ai-system/profile.json +6 -0
- package/templates/profiles/automation/brain/profile.md +19 -0
- package/templates/profiles/automation/gitignore.append +5 -0
- package/templates/profiles/automation/profile.json +6 -0
- package/templates/profiles/desktop/brain/profile.md +21 -0
- package/templates/profiles/desktop/gitignore.append +7 -0
- package/templates/profiles/desktop/profile.json +6 -0
- package/templates/profiles/mobile/brain/profile.md +20 -0
- package/templates/profiles/mobile/gitignore.append +8 -0
- package/templates/profiles/mobile/profile.json +6 -0
- package/templates/profiles/web/brain/profile.md +21 -0
- package/templates/profiles/web/gitignore.append +6 -0
- package/templates/profiles/web/profile.json +6 -0
- package/templates/project-starter/AGENTS.md +27 -0
- package/templates/project-starter/GEMINI.md +16 -0
- package/templates/project-starter/README.md +26 -0
- package/templates/project-starter/brain/INDEX.md +40 -0
- package/templates/project-starter/brain/architecture/overview.md +30 -0
- package/templates/project-starter/brain/decisions/.gitkeep +0 -0
- package/templates/project-starter/brain/manifest.yaml +36 -0
- package/templates/project-starter/brain/requirements/constraints.md +29 -0
- package/templates/project-starter/brain/requirements/prd.md +37 -0
- package/templates/project-starter/brain/state/current.yaml +19 -0
- package/templates/project-starter/gitignore.template +25 -0
- package/templates/project-starter/src/.gitkeep +0 -0
- package/templates/project-starter/tasks/.gitkeep +0 -0
- package/templates/project-starter/tests/.gitkeep +0 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 63L0
|
|
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
CHANGED
|
@@ -1,3 +1,73 @@
|
|
|
1
|
-
#
|
|
1
|
+
# GeloForge
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**Project memory and verification for AI-assisted development.**
|
|
4
|
+
|
|
5
|
+
GeloForge is a local CLI that stores decisions, scoped tasks, command results, and handoffs alongside your code.
|
|
6
|
+
|
|
7
|
+
[](https://github.com/63L0/GeloForge/actions/workflows/ci.yml)
|
|
8
|
+
[](https://www.npmjs.com/package/geloforge)
|
|
9
|
+
[](./LICENSE)
|
|
10
|
+
|
|
11
|
+

|
|
12
|
+
|
|
13
|
+
[Case study and reproduction steps](./docs/dogfooding-v06.md)
|
|
14
|
+
|
|
15
|
+
## Quick start
|
|
16
|
+
|
|
17
|
+
With Node.js 20+ and Git installed, run this from the root of an existing repository.
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
npx geloforge adopt --dry-run
|
|
21
|
+
npx geloforge adopt
|
|
22
|
+
npx geloforge status
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
The preview lists the files GeloForge would add. Adoption keeps existing project files intact. CI tests Node 20 and 22 on Linux, macOS, and Windows.
|
|
26
|
+
|
|
27
|
+
Run `npx geloforge mcp init` to configure Cursor, VS Code, Claude Code, and Gemini CLI for the project. Open the project in your client and review any MCP trust prompt.
|
|
28
|
+
|
|
29
|
+
[5-minute quickstart](./docs/quickstart-5min.md)
|
|
30
|
+
|
|
31
|
+
## Why GeloForge?
|
|
32
|
+
|
|
33
|
+
When work moves between people or coding agents, the repository carries the decisions, task scope, and last verified check. The next session can load those records as focused context. GeloForge uses local files and has zero third-party runtime dependencies.
|
|
34
|
+
|
|
35
|
+
## See it in action
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
npx geloforge task new --title "Check input validation" --activate
|
|
39
|
+
npx geloforge context --task TASK-0001 --map
|
|
40
|
+
npx geloforge verify --task TASK-0001 -- node --test
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Use the task ID printed by `task new` and your project’s own test command. A passing `verify` records the command result, saves a checkpoint, and completes the task. Use `npx geloforge evidence capture --task TASK-0001 -- node --test` to record a check and keep a task open.
|
|
44
|
+
|
|
45
|
+
## What you can do
|
|
46
|
+
|
|
47
|
+
- **Coordinate changes.** Claim a file scope to catch overlapping leases between GeloForge clients before editing.
|
|
48
|
+
- **Resume or hand off work.** Save checkpoints and share open tasks, verified evidence, and next actions with the next session.
|
|
49
|
+
- **Reuse reviewed workflows.** Draft portable `SKILL.md` files from evidence, then use signed approvals to promote or roll back versions.
|
|
50
|
+
|
|
51
|
+
## How it fits your project
|
|
52
|
+
|
|
53
|
+
| Path | Contents |
|
|
54
|
+
| --- | --- |
|
|
55
|
+
| `brain/` | Decisions, constraints, architecture, and operational state |
|
|
56
|
+
| `tasks/` | Scoped task contracts |
|
|
57
|
+
| `evidence/` | Recorded command checks and their outcomes |
|
|
58
|
+
| `handoffs/` | Handoff and checkpoint records |
|
|
59
|
+
| `.agents/skills/` | Reviewed, reusable agent workflows |
|
|
60
|
+
|
|
61
|
+
## Documentation
|
|
62
|
+
|
|
63
|
+
- [CLI and MCP guide](./docs/advanced-usage.md)
|
|
64
|
+
- [Portable Agent Skills](./docs/portable-skills.md)
|
|
65
|
+
- [Creating a new project](./docs/new-projects.md)
|
|
66
|
+
- [Known limitations](./docs/known-limitations.md) and [security policy](./SECURITY.md)
|
|
67
|
+
- [Changelog](./CHANGELOG.md) and [GitHub releases](https://github.com/63L0/GeloForge/releases)
|
|
68
|
+
|
|
69
|
+
## Contributing
|
|
70
|
+
|
|
71
|
+
Report reproducible issues with your OS, Node version, and the command you ran. [Open an issue](https://github.com/63L0/GeloForge/issues)
|
|
72
|
+
|
|
73
|
+
For local setup and pull request checks, see the [contribution guide](./CONTRIBUTING.md).
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Third-Party Notices & Pattern Attribution
|
|
2
|
+
|
|
3
|
+
GeloForge is original software released under the [MIT License](./LICENSE) (`Copyright (c) 2026 63L0`) with zero third-party npm runtime dependencies.
|
|
4
|
+
|
|
5
|
+
Several design patterns in GeloForge were informed by studying public open-source agent ecosystems. Where upstream design ideas were adapted into original Node.js code, the corresponding project, commit/version, and license notices are preserved below.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 1. NousResearch Hermes Agent (v0.4 Portable Skills Inspiration)
|
|
10
|
+
|
|
11
|
+
- **Upstream Repository:** https://github.com/NousResearch/hermes-agent
|
|
12
|
+
- **Inspected Reference Commit:** `15a495d672bee0ae6361ea523eb0854067e8d024`
|
|
13
|
+
- **License:** MIT License (`Copyright (c) 2025 Nous Research`)
|
|
14
|
+
- **Patterns Adapted in Original Node.js (`core/skills.mjs`, `core/skills-lint.mjs`, `core/skills-lifecycle.mjs`):**
|
|
15
|
+
- Separating support subdirectories (`references/`, `templates/`, `assets/`, `scripts/`) so nested documentation is never misread as standalone skills.
|
|
16
|
+
- Three-tier progressive disclosure (compact index -> relevant `SKILL.md` -> on-demand reference paths).
|
|
17
|
+
- Anti-rot skill linting heuristics (body size thresholds, trigger guidance, reference sprawl, extraneous scaffolding files, POSIX-only script portability warnings).
|
|
18
|
+
- Static security scanner categories for prompt-injection overrides, encoded shell execution, remote pipe installers, credential exfiltration, and hidden Unicode overrides (extended in GeloForge with fail-closed symlink/junction refusal, `.env*`/secret blacklists, and `A0`/quarantine isolation).
|
|
19
|
+
- Skill provenance tracking, experience-to-draft capture, isolated update diffs, and reversible revision snapshots (implemented in GeloForge with explicit verified-vs-suggested separation, Ed25519/PR-branch/TTY promotion gates, and SHA-256-verified rollback).
|
|
20
|
+
- **Attribution Note:** All code in GeloForge's skills modules was implemented from scratch in zero-dependency Node.js; no Python source files from Hermes Agent were copied verbatim.
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## 2. Agent Skills Specification (`agentskills.io`)
|
|
25
|
+
|
|
26
|
+
- **Specification:** https://agentskills.io
|
|
27
|
+
- **Usage in GeloForge:** GeloForge's portable `SKILL.md` package layout, required `name`/`description` frontmatter rules, optional `license`/`compatibility`/`metadata`/`allowed-tools` fields, and `references/` / `templates/` / `assets/` / `scripts/` conventions follow the open Agent Skills format so skills remain portable across Codex, Gemini CLI, Claude Code, and Hermes-compatible workflows.
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## 3. v0.3 Architecture & Repo-Map Research References
|
|
32
|
+
|
|
33
|
+
See [docs/research/upstream-patterns-v0.3.md](./docs/research/upstream-patterns-v0.3.md) for v0.3 design inspirations from GitHub Spec Kit (`MIT`), BMad Method (`MIT`), OpenHands (`MIT`), and Aider (`Apache-2.0` repo-map concept re-implemented cleanly in original Node.js without copying Apache-2.0 source code).
|
package/VERSION
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
0.7.0
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "GeloForge Staging Failure Delivery",
|
|
3
|
+
"active": false,
|
|
4
|
+
"nodes": [
|
|
5
|
+
{
|
|
6
|
+
"id": "11c36462-4033-40dd-8557-7f4f9c7ad010",
|
|
7
|
+
"name": "Staging Error Trigger",
|
|
8
|
+
"type": "n8n-nodes-base.errorTrigger",
|
|
9
|
+
"typeVersion": 1,
|
|
10
|
+
"position": [
|
|
11
|
+
0,
|
|
12
|
+
280
|
|
13
|
+
],
|
|
14
|
+
"parameters": {}
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"id": "11c36462-4033-40dd-8557-7f4f9c7ad011",
|
|
18
|
+
"name": "Select staging failure IDs",
|
|
19
|
+
"type": "n8n-nodes-base.code",
|
|
20
|
+
"typeVersion": 2,
|
|
21
|
+
"position": [
|
|
22
|
+
230,
|
|
23
|
+
280
|
|
24
|
+
],
|
|
25
|
+
"parameters": {
|
|
26
|
+
"jsCode": "const valid = value => typeof value === 'string' && /^[A-Za-z0-9_-]{1,64}$/.test(value);\nconst event = $input.first().json;\nconst workflowId = String(event.workflow?.id ?? '');\nconst executionId = String(event.execution?.id ?? '');\nif (!valid(workflowId) || !valid(executionId)) return [];\nreturn [{ json: { workflowId, executionId } }];"
|
|
27
|
+
}
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
"id": "11c36462-4033-40dd-8557-7f4f9c7ad012",
|
|
31
|
+
"name": "Get saved staging execution",
|
|
32
|
+
"type": "n8n-nodes-base.n8n",
|
|
33
|
+
"typeVersion": 1,
|
|
34
|
+
"position": [
|
|
35
|
+
460,
|
|
36
|
+
280
|
|
37
|
+
],
|
|
38
|
+
"parameters": {
|
|
39
|
+
"resource": "execution",
|
|
40
|
+
"operation": "get",
|
|
41
|
+
"executionId": "={{ $json.executionId }}",
|
|
42
|
+
"options": {
|
|
43
|
+
"activeWorkflows": true
|
|
44
|
+
}
|
|
45
|
+
},
|
|
46
|
+
"onError": "continueRegularOutput"
|
|
47
|
+
},
|
|
48
|
+
{
|
|
49
|
+
"id": "11c36462-4033-40dd-8557-7f4f9c7ad013",
|
|
50
|
+
"name": "Project audit evidence",
|
|
51
|
+
"type": "n8n-nodes-base.code",
|
|
52
|
+
"typeVersion": 2,
|
|
53
|
+
"position": [
|
|
54
|
+
690,
|
|
55
|
+
280
|
|
56
|
+
],
|
|
57
|
+
"parameters": {
|
|
58
|
+
"jsCode": "const ids = $('Select staging failure IDs').first().json;\nconst raw = $input.first().json;\nconst revision = raw.workflowVersionId ?? raw.workflowData?.versionId;\nconst result = raw.data?.resultData;\nconst runData = result?.runData;\nconst workflowNodes = raw.workflowData?.nodes;\nconst nodes = Array.isArray(workflowNodes) ? workflowNodes.map(node => node?.name ?? null) : null;\nconst matches = String(raw.id ?? '') === ids.executionId &&\n String(raw.workflowId ?? '') === ids.workflowId && raw.status === 'error';\nconst delivery = {\n environment: 'staging',\n ...ids,\n execution: matches ? {\n id: ids.executionId,\n workflowId: ids.workflowId,\n revision,\n status: raw.status,\n nodes,\n executed: runData && typeof runData === 'object' && !Array.isArray(runData) ? Object.keys(runData) : null,\n failedNode: result?.lastNodeExecuted ?? null,\n } : null,\n};\nconst deliveryId = String($execution.id ?? '');\nif (!/^[A-Za-z0-9_-]{1,64}$/.test(deliveryId)) throw new Error('Expected a saved delivery ID.');\nconst fileName = `failure-${ids.workflowId}-${ids.executionId}-${deliveryId}.json`;\nreturn [{\n json: { fileName },\n binary: { data: {\n data: Buffer.from(JSON.stringify(delivery), 'utf8').toString('base64'),\n mimeType: 'application/json',\n fileName,\n } },\n}];"
|
|
59
|
+
}
|
|
60
|
+
},
|
|
61
|
+
{
|
|
62
|
+
"id": "11c36462-4033-40dd-8557-7f4f9c7ad014",
|
|
63
|
+
"name": "Write audit delivery",
|
|
64
|
+
"type": "n8n-nodes-base.readWriteFile",
|
|
65
|
+
"typeVersion": 1,
|
|
66
|
+
"position": [
|
|
67
|
+
920,
|
|
68
|
+
280
|
|
69
|
+
],
|
|
70
|
+
"parameters": {
|
|
71
|
+
"operation": "write",
|
|
72
|
+
"dataPropertyName": "data",
|
|
73
|
+
"fileName": "={{ '/files/geloforge-inbox/' + $json.fileName }}",
|
|
74
|
+
"options": {}
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
],
|
|
78
|
+
"pinData": {},
|
|
79
|
+
"connections": {
|
|
80
|
+
"Staging Error Trigger": {
|
|
81
|
+
"main": [
|
|
82
|
+
[
|
|
83
|
+
{
|
|
84
|
+
"node": "Select staging failure IDs",
|
|
85
|
+
"type": "main",
|
|
86
|
+
"index": 0
|
|
87
|
+
}
|
|
88
|
+
]
|
|
89
|
+
]
|
|
90
|
+
},
|
|
91
|
+
"Select staging failure IDs": {
|
|
92
|
+
"main": [
|
|
93
|
+
[
|
|
94
|
+
{
|
|
95
|
+
"node": "Get saved staging execution",
|
|
96
|
+
"type": "main",
|
|
97
|
+
"index": 0
|
|
98
|
+
}
|
|
99
|
+
]
|
|
100
|
+
]
|
|
101
|
+
},
|
|
102
|
+
"Get saved staging execution": {
|
|
103
|
+
"main": [
|
|
104
|
+
[
|
|
105
|
+
{
|
|
106
|
+
"node": "Project audit evidence",
|
|
107
|
+
"type": "main",
|
|
108
|
+
"index": 0
|
|
109
|
+
}
|
|
110
|
+
]
|
|
111
|
+
]
|
|
112
|
+
},
|
|
113
|
+
"Project audit evidence": {
|
|
114
|
+
"main": [
|
|
115
|
+
[
|
|
116
|
+
{
|
|
117
|
+
"node": "Write audit delivery",
|
|
118
|
+
"type": "main",
|
|
119
|
+
"index": 0
|
|
120
|
+
}
|
|
121
|
+
]
|
|
122
|
+
]
|
|
123
|
+
}
|
|
124
|
+
},
|
|
125
|
+
"settings": {
|
|
126
|
+
"executionOrder": "v1",
|
|
127
|
+
"saveDataErrorExecution": "none",
|
|
128
|
+
"saveDataSuccessExecution": "none",
|
|
129
|
+
"saveManualExecutions": false,
|
|
130
|
+
"saveExecutionProgress": false
|
|
131
|
+
}
|
|
132
|
+
}
|