@n8n-as-code/skills 2.1.3 → 2.1.4-next.55
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/README.md +1 -1
- package/dist/agent-skills/n8n-architect/SKILL.md +11 -11
- package/dist/assets/n8n-credentials-ontology.json +1 -1
- package/dist/assets/n8n-docs-complete.json +9545 -9241
- package/dist/assets/n8n-knowledge-index.json +4003 -3671
- package/dist/assets/n8n-nodes-index.json +13 -13
- package/dist/assets/n8n-nodes-technical.json +14 -14
- package/dist/assets/workflows-index.json +866 -3
- package/dist/services/ai-context-generator.js +2 -2
- package/dist/services/ai-context-generator.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -259,7 +259,7 @@ If you prefer a different location, set `customNodesPath` in `n8nac-config.json`
|
|
|
259
259
|
```json
|
|
260
260
|
{
|
|
261
261
|
"host": "https://my-n8n.example.com",
|
|
262
|
-
"
|
|
262
|
+
"workflowsPath": "workflows/dev",
|
|
263
263
|
"projectId": "...",
|
|
264
264
|
"projectName": "...",
|
|
265
265
|
"customNodesPath": "./config/custom-nodes.json"
|
|
@@ -11,21 +11,21 @@ Use `{{N8NAC_CMD}}` as the primary interface. Use `{{N8N_MANAGER_CMD}}` only for
|
|
|
11
11
|
|
|
12
12
|
## Context Root Protocol
|
|
13
13
|
|
|
14
|
-
- Treat the current context root as the directory containing `n8nac-config.json`, `AGENTS.md`, `.agents/skills`, and the
|
|
14
|
+
- Treat the current context root as the directory containing `n8nac-config.json`, `AGENTS.md`, `.agents/skills`, and the configured `workflowsPath`.
|
|
15
15
|
- {{N8NAC_CONTEXT_ROOT_HINT}}
|
|
16
16
|
- Before any n8n work, first run `{{N8NAC_CMD}} update-ai` from the context root, then read `AGENTS.md`. `update-ai` is designed to create or refresh the n8n-as-code block without destroying existing user or agent instructions.
|
|
17
17
|
- Use the exact `n8nac command` and `n8n-manager command` listed in `AGENTS.md`. Those context-root commands override the portable examples in this skill.
|
|
18
18
|
- Run every `{{N8NAC_CMD}} env ...`, `{{N8NAC_CMD}} workspace ...`, `{{N8NAC_CMD}} list`, `pull`, `push`, `validate`, `test`, and `update-ai` command from the context root unless the user explicitly gives another context root.
|
|
19
19
|
- `AGENTS.md` is bootstrap context only, not a source of configuration truth.
|
|
20
|
-
- Do not infer environment, project,
|
|
20
|
+
- Do not infer environment, project, or `workflowsPath` from `AGENTS.md`.
|
|
21
21
|
- Before n8n work, resolve the effective context from the backend:
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
24
|
{{N8NAC_CMD}} env status --json
|
|
25
25
|
```
|
|
26
26
|
|
|
27
|
-
- Use the returned `
|
|
28
|
-
-
|
|
27
|
+
- Use the returned `workflowsPath` for workflow files. It is the configured workflow directory for the active environment.
|
|
28
|
+
- Do not reconstruct `workflowsPath` from environment name/id, `instanceIdentifier`, `instanceUserIdentifier`, `projectId`, `projectName`, or legacy sync fields.
|
|
29
29
|
- Never write `n8nac-config.json`, `~/.n8n-manager`, or n8n-manager secret files by hand.
|
|
30
30
|
|
|
31
31
|
## Workspace Readiness
|
|
@@ -82,7 +82,7 @@ Migration is one user-facing command. Do not reason about internal migration pha
|
|
|
82
82
|
10. Configure the environment with:
|
|
83
83
|
|
|
84
84
|
```bash
|
|
85
|
-
{{N8NAC_CMD}} env add <name> --base-url <url> --
|
|
85
|
+
{{N8NAC_CMD}} env add <name> --base-url <url> --workflows-path workflows/<name>
|
|
86
86
|
{{N8NAC_CMD}} env auth set <name> --api-key-stdin
|
|
87
87
|
{{N8NAC_CMD}} env use <name>
|
|
88
88
|
```
|
|
@@ -90,7 +90,7 @@ Migration is one user-facing command. Do not reason about internal migration pha
|
|
|
90
90
|
For a managed local instance:
|
|
91
91
|
|
|
92
92
|
```bash
|
|
93
|
-
{{N8NAC_CMD}} env add Local --managed-instance <id> --
|
|
93
|
+
{{N8NAC_CMD}} env add Local --managed-instance <id> --workflows-path workflows/local
|
|
94
94
|
{{N8NAC_CMD}} env use Local
|
|
95
95
|
```
|
|
96
96
|
|
|
@@ -98,12 +98,12 @@ For a managed local instance:
|
|
|
98
98
|
|
|
99
99
|
## Environments
|
|
100
100
|
|
|
101
|
-
Use `{{N8NAC_CMD}} env ...` for workspace environments, remote URLs, active environment, API-key binding, projects, and
|
|
101
|
+
Use `{{N8NAC_CMD}} env ...` for workspace environments, remote URLs, active environment, API-key binding, projects, and workflow paths.
|
|
102
102
|
|
|
103
103
|
```bash
|
|
104
104
|
{{N8NAC_CMD}} env status --json
|
|
105
105
|
{{N8NAC_CMD}} env list
|
|
106
|
-
{{N8NAC_CMD}} env add <name> --base-url <url> --
|
|
106
|
+
{{N8NAC_CMD}} env add <name> --base-url <url> --workflows-path workflows/<name>
|
|
107
107
|
{{N8NAC_CMD}} env auth set <name> --api-key-stdin
|
|
108
108
|
{{N8NAC_CMD}} env use <name>
|
|
109
109
|
```
|
|
@@ -117,7 +117,7 @@ Use `{{N8NAC_CMD}} env ...` for workspace environments, remote URLs, active envi
|
|
|
117
117
|
Attach a managed local instance to the workspace with `{{N8NAC_CMD}} env ...`:
|
|
118
118
|
|
|
119
119
|
```bash
|
|
120
|
-
{{N8NAC_CMD}} env add Local --managed-instance <id> --
|
|
120
|
+
{{N8NAC_CMD}} env add Local --managed-instance <id> --workflows-path workflows/local
|
|
121
121
|
{{N8NAC_CMD}} env use Local
|
|
122
122
|
```
|
|
123
123
|
|
|
@@ -195,7 +195,7 @@ Instance and tunnel operations are per managed local instance:
|
|
|
195
195
|
```
|
|
196
196
|
|
|
197
197
|
- `push` requires the full workflow file path, either absolute or context-root-relative. Do not pass a bare filename.
|
|
198
|
-
- For a new workflow, create the file inside the `
|
|
198
|
+
- For a new workflow, create the file inside the `workflowsPath` returned by `env status --json`, then confirm it with `{{N8NAC_CMD}} list --local`.
|
|
199
199
|
- If push/pull reports a conflict, use explicit resolution commands. Do not overwrite remote changes blindly.
|
|
200
200
|
- `pull` and conflict resolution operate on a single workflow ID.
|
|
201
201
|
- `list` is the lightweight command that covers all workflows at once.
|
|
@@ -491,7 +491,7 @@ When a workflow is blocked by missing credentials, resolve the credential gap wi
|
|
|
491
491
|
For most workflow tasks:
|
|
492
492
|
|
|
493
493
|
1. Resolve context with `env status --json`.
|
|
494
|
-
2. Read `
|
|
494
|
+
2. Read `workflowsPath` from the backend response.
|
|
495
495
|
3. Inspect existing workflows with `list`.
|
|
496
496
|
4. Pull before editing an existing workflow.
|
|
497
497
|
5. Search examples and schemas.
|