@copado/agentia-cli 0.98.0-alpha.0 → 0.100.0-alpha.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/README.md +209 -198
- package/dist/commands/cicd/work/push.js +1 -0
- package/dist/commands/cicd/work/push.js.map +1 -1
- package/dist/commands/cicd/work/set.d.ts +6 -3
- package/dist/commands/cicd/work/set.js +58 -5
- package/dist/commands/cicd/work/set.js.map +1 -1
- package/dist/commands/cicd/work/test.d.ts +1 -0
- package/dist/commands/cicd/work/test.js +16 -7
- package/dist/commands/cicd/work/test.js.map +1 -1
- package/dist/lib/defaults-store.d.ts +10 -0
- package/dist/lib/defaults-store.js +23 -0
- package/dist/lib/defaults-store.js.map +1 -1
- package/dist/lib/git-worktree.d.ts +13 -0
- package/dist/lib/git-worktree.js +36 -0
- package/dist/lib/git-worktree.js.map +1 -1
- package/dist/lib/mcp/tools.d.ts +4 -2
- package/dist/lib/mcp/work-tools.d.ts +5 -3
- package/dist/lib/mcp/work-tools.js +29 -8
- package/dist/lib/mcp/work-tools.js.map +1 -1
- package/dist/lib/setup-templates.d.ts +2 -2
- package/dist/lib/setup-templates.js +3 -3
- package/dist/lib/setup-templates.js.map +1 -1
- package/dist/lib/work-push.js +26 -10
- package/dist/lib/work-push.js.map +1 -1
- package/dist/lib/work-set-none.d.ts +14 -0
- package/dist/lib/work-set-none.js +58 -0
- package/dist/lib/work-set-none.js.map +1 -0
- package/dist/lib/work-types.d.ts +10 -0
- package/dist/lib/work-types.js.map +1 -1
- package/oclif.manifest.json +4271 -4257
- package/package.json +1 -1
- package/templates/skills/agentia-cicd/SKILL.md +1 -1
- package/templates/skills/agentia-cicd/references/work.md +6 -6
package/package.json
CHANGED
|
@@ -33,7 +33,7 @@ Prefer Agentia MCP tools when they are available and match the task. Use CLI exa
|
|
|
33
33
|
- Keep human output off stdout in JSON workflows. Prefer `--json`, then parse the result object.
|
|
34
34
|
- For local project work, keep the tracked working tree clean before commands that require it: `work set`, `work push`, and `work submit`.
|
|
35
35
|
- Treat `cicd job` as Copado CICD JobExecution. It is different from CRT `testing job`.
|
|
36
|
-
- Treat `cicd work test
|
|
36
|
+
- Treat `cicd work test` as local quality gates (`--local` is the default). It is different from CRT `testing test run`.
|
|
37
37
|
- Treat `auth` credentials as keychain/API credentials and `cicd credential` records as Copado environment credentials.
|
|
38
38
|
|
|
39
39
|
## Report Back
|
|
@@ -15,7 +15,7 @@ Use this path when the change exists in the local repository:
|
|
|
15
15
|
1. Discover and inspect: `agentia cicd work list --assigned-to-me --json`, then `agentia cicd work get <id-or-name> --json`.
|
|
16
16
|
2. Activate: `agentia cicd work set <id-or-name> --json`. This fetches the configured base branch, checks out `feature/<story-name>`, and records the story, base branch, dev org branch, and pull-request context in `.agentia/config.user.json`. Use `--base-branch <branch>` only when intentionally overriding the Pipeline default.
|
|
17
17
|
3. Implement and stage new files with `git add`. Commit with Git, or use `agentia cicd work commit --local --all --json` when Agentia should also remember permission, full-metadata, or Apex-test selections. `--local` is the default, and `--all` includes tracked changes only.
|
|
18
|
-
4. Run project-owned gates: `agentia cicd work test --
|
|
18
|
+
4. Run project-owned gates: `agentia cicd work test --json`. This runs `.agentia_quality_gates.sh` or `.agentia_quality_gates.cmd` from the repository root when present. `--local` is the default; `--cloud` is reserved and not implemented yet.
|
|
19
19
|
5. Register and synchronize: `agentia cicd work push --json`. A plain `git push` does not register a Copado Commit or merge the feature branch into the recorded dev org branch.
|
|
20
20
|
6. Validate and open the merge-request flow: `agentia cicd work submit --json`. Submit runs the local gates unless `--skip-local-tests` is explicit, pushes ahead commits, and submits with validate-only behavior.
|
|
21
21
|
7. Only with explicit approval to promote and deploy, run `agentia cicd work submit --done --json`. `work done` is a compatibility alias.
|
|
@@ -42,10 +42,10 @@ Cloud commit checks Story readiness and source credentials before submission. Av
|
|
|
42
42
|
| `work get [ID]` | Read story details | ID is optional after `work set`. Human output redacts OAuth signatures; JSON preserves structured fields. |
|
|
43
43
|
| `work create` | Create a story | Use `--title`, project/team/assignee/theme fields, specs, and short acceptance criteria. |
|
|
44
44
|
| `work update [ID]` | Mutate story fields or status | ID is optional after `work set`. Acceptance criteria must be fewer than 255 chars. |
|
|
45
|
-
| `work set ID` | Mark active and prepare branch | Fetches base branch, creates/checks out `feature/<story-name>`, stores local context. |
|
|
45
|
+
| `work set ID` | Mark active and prepare branch | Fetches base branch, creates/checks out `feature/<story-name>`, stores local context. `--none` clears every `last*` key and checks out `lastBaseBranch`, else `main`, else `master`. |
|
|
46
46
|
| `work commit` | Local or cloud commit | The flag sets are disjoint. `--local` is default and performs no gateway call; `--cloud` calls Copado commit APIs and polls by default. |
|
|
47
47
|
| `work push` | Push local commits and register with Copado | Requires active story context and clean tree. Sends stored retrieve-only permissions. |
|
|
48
|
-
| `work test
|
|
48
|
+
| `work test` | Run local quality gate scripts | `--local` is default. Runs `.agentia_quality_gates.sh` or `.agentia_quality_gates.cmd` from repo root. `--cloud` is not implemented yet. |
|
|
49
49
|
| `work submit` | Submit for review/validation or promote | Runs local gates unless `--skip-local-tests`; can push ahead commits. `--done` matches Copado UI Submit when promoting. |
|
|
50
50
|
| `work done` | Compatibility alias | Prefer `work submit --done`; both promote and deploy rather than validate-only. |
|
|
51
51
|
| `work promote` | Story-centric promotion run | Requires `--cloud`; use `--deploy` for merge and deploy. |
|
|
@@ -59,14 +59,14 @@ Use local commits for normal source changes. Stage new files explicitly because
|
|
|
59
59
|
```sh
|
|
60
60
|
git add -A
|
|
61
61
|
agentia cicd work commit --local --all --permissions CustomField:Account.SLA__c,ApexClass:AccountService --json
|
|
62
|
-
agentia cicd work test --
|
|
62
|
+
agentia cicd work test --json
|
|
63
63
|
agentia cicd work push --json
|
|
64
64
|
agentia cicd work submit --json
|
|
65
65
|
```
|
|
66
66
|
|
|
67
67
|
`--permissions` records metadata that Copado should treat as Retrieve Only during push. List the components whose access changed, not the permission set or profile files. Use `--full-metadata` only when a profile or permission set should travel as a complete file, because it can overwrite permissions the Story did not touch. Both selections are sticky in local user config until replaced or cleared with an empty value. Push-time selections apply only to that push.
|
|
68
68
|
|
|
69
|
-
`--apex-test-classes` records story-related test class names for later reference. `work test
|
|
69
|
+
`--apex-test-classes` records story-related test class names for later reference. `work test` and `work submit` still take `--apex-test-classes` explicitly when you want the local gate script to receive them.
|
|
70
70
|
|
|
71
71
|
`work push` detects nested metadata across the full branch diff from the merge base to `HEAD`, applies Copado environment-variable and YAML replacements, registers every commit in the range, and merges into the recorded dev org branch. Review unexpected Retrieve Only, Full Metadata, or nested-deletion output before continuing.
|
|
72
72
|
|
|
@@ -108,7 +108,7 @@ Prefer explicit flags for standard step types. Use `--config-json`, `--file`, or
|
|
|
108
108
|
|
|
109
109
|
## Gotchas
|
|
110
110
|
|
|
111
|
-
- `work test
|
|
111
|
+
- `work test` is not CRT. For Robot Framework execution, use the `agentia-testing` skill.
|
|
112
112
|
- Local `work commit` rejects Story IDs and cloud-only flags; cloud `work commit --cloud` rejects local-only flags.
|
|
113
113
|
- `work submit` may push ahead commits, but the local flow still needs story and branch context from `work set`.
|
|
114
114
|
- `work submit --done` promotes/deploys. Do not run it unless the user explicitly asked to promote or finish the story.
|