@jentrix/cli 0.5.14 → 0.5.16
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/claude-plugin/.claude-plugin/plugin.json +1 -1
- package/claude-plugin/commands/jentrix-align.md +23 -6
- package/claude-plugin/commands/jentrix-checkpoint.md +1 -0
- package/claude-plugin/commands/jentrix-connect.md +1 -0
- package/claude-plugin/commands/jentrix-end.md +1 -0
- package/claude-plugin/commands/jentrix-plan.md +1 -0
- package/claude-plugin/commands/jentrix-review.md +1 -0
- package/claude-plugin/commands/jentrix-status.md +1 -0
- package/codex-plugin/plugins/jentrix/.codex-plugin/plugin.json +1 -1
- package/codex-plugin/plugins/jentrix/skills/jentrix-align/SKILL.md +15 -2
- package/codex-plugin/plugins/jentrix/skills/jentrix-checkpoint/SKILL.md +1 -0
- package/codex-plugin/plugins/jentrix/skills/jentrix-connect/SKILL.md +1 -0
- package/codex-plugin/plugins/jentrix/skills/jentrix-end/SKILL.md +1 -0
- package/codex-plugin/plugins/jentrix/skills/jentrix-plan/SKILL.md +1 -0
- package/codex-plugin/plugins/jentrix/skills/jentrix-review/SKILL.md +1 -0
- package/codex-plugin/plugins/jentrix/skills/jentrix-status/SKILL.md +1 -0
- package/dist/main.js +317 -153
- package/package.json +1 -1
- package/surface.json +0 -242
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "jentrix",
|
|
3
3
|
"description": "Connect this Claude Code session to a Jentrix project: /jentrix-connect binds the current session (trusted lifecycle hooks supply the session id), /jentrix-align runs the MVP alignment wizard, /jentrix-status and /jentrix-end wrap the same session operations. Business logic lives in the Jentrix CLI — removing this plugin leaves `jentrix session attach` as the universal fallback.",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.2"
|
|
5
5
|
}
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
description: Align this session to a Jentrix work layer (workspace → project → task → owner) with a server-confirmed alignment snapshot
|
|
3
3
|
allowed-tools: Bash(jentrix align:*), Bash(jentrix session:*)
|
|
4
4
|
---
|
|
5
|
+
<!-- Source of truth. The cli/{claude,codex}-plugin copy is GENERATED by cli/scripts/build.mjs (rm + cp) on every build — edits made there are deleted. Edit this file. -->
|
|
5
6
|
|
|
6
7
|
Run the Jentrix MVP alignment wizard for THIS session. The question set is
|
|
7
8
|
fixed — workspace, project, project name, work item, task title, owner,
|
|
@@ -20,6 +21,15 @@ and do NOT answer any question yourself.
|
|
|
20
21
|
3. If `currentAlignment` is non-null: show it to the operator and ask —
|
|
21
22
|
using the native choice UI (AskUserQuestion) — whether to keep it or
|
|
22
23
|
re-align. Keep → relay the current snapshot and stop.
|
|
24
|
+
**Fast path.** If the payload's only `ask` question is `confirmation`
|
|
25
|
+
(project / work item / owner were pre-filled from this checkout's previous
|
|
26
|
+
alignment and the confirmation prompt says so — "continuing this
|
|
27
|
+
checkout's previous alignment …"), present that prompt VERBATIM through
|
|
28
|
+
the choice UI. Confirm ⇒ submit with the answered values exactly as the
|
|
29
|
+
payload shows them (`--project <id> --task <id>|--session-level --owner
|
|
30
|
+
<id>`). Re-answer ⇒ re-run `jentrix align --questions --json --fresh` and
|
|
31
|
+
continue with the full flow below, passing `--fresh` on the final submit
|
|
32
|
+
too.
|
|
23
33
|
4. For each question whose `status` is `"ask"`, present its `choices`
|
|
24
34
|
verbatim through the native choice UI (AskUserQuestion), preserving the
|
|
25
35
|
labels. If the question carries a `notice`, relay it to the operator
|
|
@@ -28,12 +38,19 @@ and do NOT answer any question yourself.
|
|
|
28
38
|
choice is the explicit free-text escape: when picked, let the operator
|
|
29
39
|
type the id/slug. A question whose `status` is `"skipped"` was resolved
|
|
30
40
|
by detection — tell the operator what was resolved (e.g. the workspace),
|
|
31
|
-
don't re-ask it.
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
41
|
+
don't re-ask it. When a question carries more choices than the native
|
|
42
|
+
picker can show (the work-item question can carry up to 15 tasks plus its
|
|
43
|
+
escapes), put the overflow choices — label AND id — in the prompt text and
|
|
44
|
+
say they are reachable through "Other…". Never silently drop a choice.
|
|
45
|
+
5. Re-run `--questions --json` after every answer that unlocks the next
|
|
46
|
+
question, carrying the answers so far as flags. After the WORKSPACE
|
|
47
|
+
answer: `jentrix align --questions --json --workspace <chosen>` — it
|
|
48
|
+
narrows the project list to that workspace, and without it the project
|
|
49
|
+
question stays `pending` and the flow stalls. After the PROJECT answer:
|
|
50
|
+
`jentrix align --questions --json [--workspace <chosen>] --project <chosen>`
|
|
51
|
+
loads the work-item and owner choices, then continue asking. If the
|
|
52
|
+
operator picked "Create a new project from this repo", the NEXT question
|
|
53
|
+
is `project_name` (already in the payload, `kind: "freetext"`): relay its
|
|
37
54
|
`prompt` verbatim and collect the name as free text FROM THE OPERATOR —
|
|
38
55
|
never propose name options, never fill it in yourself. Then re-run
|
|
39
56
|
`jentrix align --questions --json --new-project "<name>"` — the work-item
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
description: Write a distilled state-of-play for this session and push it as a typed Jentrix artifact
|
|
3
3
|
allowed-tools: Bash(jentrix push:*), Bash(jentrix session:*), Bash(jentrix task:*)
|
|
4
4
|
---
|
|
5
|
+
<!-- Source of truth. The cli/{claude,codex}-plugin copy is GENERATED by cli/scripts/build.mjs (rm + cp) on every build — edits made there are deleted. Edit this file. -->
|
|
5
6
|
|
|
6
7
|
Write down what this session currently knows, and push it.
|
|
7
8
|
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
description: Connect this Claude Code session to a Jentrix project (session anchor + capture)
|
|
3
3
|
allowed-tools: Bash(jentrix session:*)
|
|
4
4
|
---
|
|
5
|
+
<!-- Source of truth. The cli/{claude,codex}-plugin copy is GENERATED by cli/scripts/build.mjs (rm + cp) on every build — edits made there are deleted. Edit this file. -->
|
|
5
6
|
|
|
6
7
|
Run this exact command with the Bash tool and relay its output to the user:
|
|
7
8
|
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
description: End the connected Jentrix session (pushes the final artifacts, verifies capture, stores the RUN_SUMMARY)
|
|
3
3
|
allowed-tools: Bash(jentrix session:*), Bash(jentrix push:*), Bash(jentrix artifact:*), Bash(jentrix column:*), Bash(jentrix task:*), Bash(jentrix tool:*)
|
|
4
4
|
---
|
|
5
|
+
<!-- Source of truth. The cli/{claude,codex}-plugin copy is GENERATED by cli/scripts/build.mjs (rm + cp) on every build — edits made there are deleted. Edit this file. -->
|
|
5
6
|
|
|
6
7
|
End the connected Jentrix session honestly. For an ALIGNED session (the MVP
|
|
7
8
|
pipeline), the typed artifacts ARE the record — push them before closing:
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
description: Turn the opening prompt into a goal and a small set of Jentrix tasks, confirmed by the operator before anything is created
|
|
3
3
|
allowed-tools: Bash(jentrix task:*), Bash(jentrix column:*), Bash(jentrix board:*), Bash(jentrix session:*), Bash(jentrix push:*)
|
|
4
4
|
---
|
|
5
|
+
<!-- Source of truth. The cli/{claude,codex}-plugin copy is GENERATED by cli/scripts/build.mjs (rm + cp) on every build — edits made there are deleted. Edit this file. -->
|
|
5
6
|
|
|
6
7
|
Decompose the work the operator just asked for into a goal and a short task
|
|
7
8
|
list, **confirm both before creating anything**, then create them.
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
description: Review a Jentrix session's typed artifacts by category (input → plan → decision → output → issue → gap → learning → record), check the readiness contract, and post the verdict as a task comment
|
|
3
3
|
allowed-tools: Bash(jentrix tool:*), Bash(jentrix artifact:*), Bash(jentrix session:*), Bash(jentrix comment:*)
|
|
4
4
|
---
|
|
5
|
+
<!-- Source of truth. The cli/{claude,codex}-plugin copy is GENERATED by cli/scripts/build.mjs (rm + cp) on every build — edits made there are deleted. Edit this file. -->
|
|
5
6
|
|
|
6
7
|
Run the category walk over one session's record (docs: Reviewing a session).
|
|
7
8
|
Read-only until the final comment; never modify the tree, the board, or the
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
description: Show the connected Jentrix session for this work (capture health included)
|
|
3
3
|
allowed-tools: Bash(jentrix session:*)
|
|
4
4
|
---
|
|
5
|
+
<!-- Source of truth. The cli/{claude,codex}-plugin copy is GENERATED by cli/scripts/build.mjs (rm + cp) on every build — edits made there are deleted. Edit this file. -->
|
|
5
6
|
|
|
6
7
|
Run `jentrix session status` with the Bash tool (append the session id if the
|
|
7
8
|
user gave one) and relay the output verbatim, including any capture-pending
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
name: stacks-align
|
|
3
3
|
description: Align the current Codex task to a Jentrix workspace, project, work item, and owner with an operator-confirmed server snapshot.
|
|
4
4
|
---
|
|
5
|
+
<!-- Source of truth. The cli/{claude,codex}-plugin copy is GENERATED by cli/scripts/build.mjs (rm + cp) on every build — edits made there are deleted. Edit this file. -->
|
|
5
6
|
|
|
6
7
|
# Align this Codex task
|
|
7
8
|
|
|
@@ -9,11 +10,23 @@ description: Align the current Codex task to a Jentrix workspace, project, work
|
|
|
9
10
|
2. Relay every failed or warning precondition before asking anything.
|
|
10
11
|
3. If `currentAlignment` exists, ask whether to keep it or re-align. Keep means
|
|
11
12
|
show the current snapshot and stop.
|
|
13
|
+
Fast path: if the payload's only `ask` question is `confirmation` (project /
|
|
14
|
+
work item / owner were pre-filled from this checkout's previous alignment and
|
|
15
|
+
the confirmation prompt says so), present that prompt verbatim. Confirm ⇒
|
|
16
|
+
submit with the answered values exactly as the payload shows them
|
|
17
|
+
(`--project <id> --task <id>|--session-level --owner <id>`). Re-answer ⇒
|
|
18
|
+
re-run `jentrix align --provider codex --questions --json --fresh` and
|
|
19
|
+
continue with the full flow below, passing `--fresh` on the final submit too.
|
|
12
20
|
4. Present each `status:"ask"` question and its choices verbatim using Codex's
|
|
13
21
|
structured input UI when available, otherwise ask in chat. Never answer for the
|
|
14
22
|
operator. Preserve notices and the `Other…` free-text escape.
|
|
15
|
-
5. Re-run `--questions --json` after
|
|
16
|
-
|
|
23
|
+
5. Re-run `--questions --json` after every answer that unlocks the next question,
|
|
24
|
+
carrying the answers so far: `--workspace <chosen>` after the workspace (it
|
|
25
|
+
narrows the project list — without it the project question stays `pending`),
|
|
26
|
+
then `--project <chosen>`. Collect `project_name` and `task_title` as free text
|
|
27
|
+
from the operator; never propose permanent names. When the choices outnumber
|
|
28
|
+
the front end's picker, name the overflow (label + id) in the prompt rather
|
|
29
|
+
than dropping it.
|
|
17
30
|
6. Present the confirmation prompt and every disclosure verbatim.
|
|
18
31
|
7. On confirmation, submit exactly once with `jentrix align --provider codex --json
|
|
19
32
|
--yes` plus the confirmed project, task/session-level, owner, agent label, and
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
name: stacks-checkpoint
|
|
3
3
|
description: Distill verified session state into a typed Jentrix checkpoint that survives compaction or handoff.
|
|
4
4
|
---
|
|
5
|
+
<!-- Source of truth. The cli/{claude,codex}-plugin copy is GENERATED by cli/scripts/build.mjs (rm + cp) on every build — edits made there are deleted. Edit this file. -->
|
|
5
6
|
|
|
6
7
|
# Write a checkpoint
|
|
7
8
|
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
name: stacks-connect
|
|
3
3
|
description: Connect the current Codex task to a Jentrix project using trusted lifecycle identity and start the session capture host.
|
|
4
4
|
---
|
|
5
|
+
<!-- Source of truth. The cli/{claude,codex}-plugin copy is GENERATED by cli/scripts/build.mjs (rm + cp) on every build — edits made there are deleted. Edit this file. -->
|
|
5
6
|
|
|
6
7
|
# Connect this Codex task
|
|
7
8
|
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
name: stacks-end
|
|
3
3
|
description: End a connected Jentrix session after preserving approved outputs, parking completed work in review, and reporting capture honestly.
|
|
4
4
|
---
|
|
5
|
+
<!-- Source of truth. The cli/{claude,codex}-plugin copy is GENERATED by cli/scripts/build.mjs (rm + cp) on every build — edits made there are deleted. Edit this file. -->
|
|
5
6
|
|
|
6
7
|
# End the connected session
|
|
7
8
|
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
name: stacks-plan
|
|
3
3
|
description: Turn the opening request into an operator-approved goal and small Jentrix task set, then store the prompt and goal as typed artifacts.
|
|
4
4
|
---
|
|
5
|
+
<!-- Source of truth. The cli/{claude,codex}-plugin copy is GENERATED by cli/scripts/build.mjs (rm + cp) on every build — edits made there are deleted. Edit this file. -->
|
|
5
6
|
|
|
6
7
|
# Plan confirmed work
|
|
7
8
|
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
name: stacks-review
|
|
3
3
|
description: Review a Jentrix session's typed artifacts by category, verify the readiness contract, and post the verdict as a comment on the aligned task.
|
|
4
4
|
---
|
|
5
|
+
<!-- Source of truth. The cli/{claude,codex}-plugin copy is GENERATED by cli/scripts/build.mjs (rm + cp) on every build — edits made there are deleted. Edit this file. -->
|
|
5
6
|
|
|
6
7
|
# Review a session's record
|
|
7
8
|
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
name: stacks-status
|
|
3
3
|
description: Show the connected Jentrix session, alignment, capture health, and honest telemetry availability for this Codex task.
|
|
4
4
|
---
|
|
5
|
+
<!-- Source of truth. The cli/{claude,codex}-plugin copy is GENERATED by cli/scripts/build.mjs (rm + cp) on every build — edits made there are deleted. Edit this file. -->
|
|
5
6
|
|
|
6
7
|
# Show session status
|
|
7
8
|
|