kordexa 0.0.0-stage → 0.4.3
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/commands/eduorchestrate-card.md +5 -0
- package/.claude/commands/eduorchestrate-log.md +6 -0
- package/.claude/commands/eduorchestrate-next.md +5 -0
- package/.claude/commands/eduorchestrate-research.md +6 -0
- package/.claude/commands/eduorchestrate-send.md +5 -0
- package/.claude/commands/eduorchestrate-status.md +5 -0
- package/.claude/commands/eduorchestrate-weekly.md +6 -0
- package/.claude/commands/kordexa-card.md +5 -0
- package/.claude/commands/kordexa-log.md +6 -0
- package/.claude/commands/kordexa-next.md +5 -0
- package/.claude/commands/kordexa-research.md +6 -0
- package/.claude/commands/kordexa-send.md +5 -0
- package/.claude/commands/kordexa-status.md +5 -0
- package/.claude/commands/kordexa-weekly.md +6 -0
- package/.claude/skills/eduorchestrate/SKILL.md +24 -0
- package/.claude/skills/kordexa/SKILL.md +24 -0
- package/.eduorchestrate/adapters/antigravity/manifest.json +31 -0
- package/.eduorchestrate/adapters/codex/AGENTS.md +23 -0
- package/.eduorchestrate/adapters/generic/EDUORCHESTRATE.md +19 -0
- package/.eduorchestrate/adapters/hermas/manifest.json +31 -0
- package/.eduorchestrate/adapters/openclaw/SKILL.md +24 -0
- package/.eduorchestrate/mcp/manifest.json +19 -0
- package/.eduorchestrate/mcp/server.js +47 -0
- package/.kordexa/adapters/antigravity/manifest.json +31 -0
- package/.kordexa/adapters/codex/AGENTS.md +23 -0
- package/.kordexa/adapters/generic/KORDEXA.md +19 -0
- package/.kordexa/adapters/hermas/manifest.json +31 -0
- package/.kordexa/adapters/openclaw/SKILL.md +24 -0
- package/.kordexa/mcp/manifest.json +19 -0
- package/.kordexa/mcp/server.js +47 -0
- package/AGENTS.md +25 -0
- package/GEMINI.md +7 -0
- package/LICENSE +22 -0
- package/README.md +311 -2
- package/agents/eduorchestrate-agent.yaml +18 -0
- package/agents/kordexa-agent.yaml +18 -0
- package/bin/kordexa.js +14 -0
- package/package.json +38 -4
- package/skills/eduorchestrate/SKILL.md +115 -0
- package/skills/eduorchestrate/agents/openai.yaml +4 -0
- package/skills/eduorchestrate/assets/default-terminal-card.svg +1 -0
- package/skills/eduorchestrate/references/agent-contracts.md +107 -0
- package/skills/eduorchestrate/references/learning-system.md +119 -0
- package/skills/kordexa/SKILL.md +115 -0
- package/skills/kordexa/agents/openai.yaml +4 -0
- package/skills/kordexa/assets/default-terminal-card.svg +1 -0
- package/skills/kordexa/references/agent-contracts.md +107 -0
- package/skills/kordexa/references/learning-system.md +119 -0
- package/src/adapters.js +203 -0
- package/src/card-components.js +103 -0
- package/src/cli.js +637 -0
- package/src/config.js +118 -0
- package/src/courses.js +150 -0
- package/src/email.js +241 -0
- package/src/harness.js +130 -0
- package/src/planner.js +423 -0
- package/src/progress.js +93 -0
- package/src/progression-card.js +137 -0
- package/src/prompts.js +461 -0
- package/src/research.js +295 -0
- package/src/setup-answers.js +282 -0
- package/src/workflow.js +164 -0
- package/tests/node/eduorchestrate.test.js +558 -0
- package/tests/node/guided-setup.test.js +366 -0
- package/tests/node/launch-ready.test.js +101 -0
- package/tests/node/resend.test.js +177 -0
- package/tests/node/safe-setup.test.js +313 -0
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: EduOrchestrate: render the skill progression card
|
|
3
|
+
allowed-tools: Bash(npx kordexa progress-card:*)
|
|
4
|
+
---
|
|
5
|
+
Render the learner's skill progression card. Run `npx kordexa progress-card` and show completed/total days, the commit-style grid, and the terminal-card status lines. Mention the saved data/terminal-card.svg.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: EduOrchestrate: log today's progress with evidence
|
|
3
|
+
argument-hint: <what you did> | <evidence link>
|
|
4
|
+
allowed-tools: Bash(npx kordexa log-progress:*), Bash(npx kordexa status:*)
|
|
5
|
+
---
|
|
6
|
+
Log the learner's progress. Read what they completed and an evidence link/path from "$ARGUMENTS". If either is missing, ASK for it — never log a placeholder entry. Read the current day from `npx kordexa status`, then run `npx kordexa log-progress --day <day> --completed "<note>" --evidence "<link>"` (optionally --confidence <1-5>) and confirm the updated momentum.
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: EduOrchestrate: recommend the next skill after the plan window
|
|
3
|
+
allowed-tools: Bash(npx kordexa recommend-next:*)
|
|
4
|
+
---
|
|
5
|
+
Recommend the next skill. Run `npx kordexa recommend-next` and present whether the learner can advance, the recommended next skill, and the reason.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: EduOrchestrate: resolve today's sourced links (video, docs, repo)
|
|
3
|
+
argument-hint: [day]
|
|
4
|
+
allowed-tools: Bash(npx kordexa research:*), Bash(npx kordexa status:*)
|
|
5
|
+
---
|
|
6
|
+
Resolve the learner's research links. If "$ARGUMENTS" contains a day number use it, otherwise read the current day from `npx kordexa status`. Then run `npx kordexa research --day <day>` and present the resolved top YouTube video link (with its title), the official docs, and the GitHub repo result. Keep it short and link-first.
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: EduOrchestrate: preview today's learning email (dry-run, never sends)
|
|
3
|
+
allowed-tools: Bash(npx kordexa send-today --dry-run:*)
|
|
4
|
+
---
|
|
5
|
+
Preview today's EduOrchestrate email. Run `npx kordexa send-today --dry-run` and summarize what would be sent: subject, the top video link, docs, build task, and timebox. This command is preview-only — never run it without --dry-run.
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: EduOrchestrate: current learning day, momentum, and next action
|
|
3
|
+
allowed-tools: Bash(npx kordexa status:*)
|
|
4
|
+
---
|
|
5
|
+
Show the learner's EduOrchestrate status. Run `npx kordexa status` and present, using only the command output: learner, role, primary skill, currently learning, active day, progress (completed/total), momentum, risk, and the next action. Do not invent values.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: EduOrchestrate: summarize a learning week
|
|
3
|
+
argument-hint: [week]
|
|
4
|
+
allowed-tools: Bash(npx kordexa weekly-summary:*)
|
|
5
|
+
---
|
|
6
|
+
Summarize a learning week. Run `npx kordexa weekly-summary --week <n>` (n from "$ARGUMENTS", default 1) and present planned vs completed days and the next-week focus.
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Kordexa: render the skill progression card
|
|
3
|
+
allowed-tools: Bash(npx kordexa progress-card:*)
|
|
4
|
+
---
|
|
5
|
+
Render the learner's skill progression card. Run `npx kordexa progress-card` and show completed/total days, the commit-style grid, and the terminal-card status lines. Mention the saved data/terminal-card.svg.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Kordexa: log today's progress with evidence
|
|
3
|
+
argument-hint: <what you did> | <evidence link>
|
|
4
|
+
allowed-tools: Bash(npx kordexa log-progress:*), Bash(npx kordexa status:*)
|
|
5
|
+
---
|
|
6
|
+
Log the learner's progress. Read what they completed and an evidence link/path from "$ARGUMENTS". If either is missing, ASK for it — never log a placeholder entry. Read the current day from `npx kordexa status`, then run `npx kordexa log-progress --day <day> --completed "<note>" --evidence "<link>"` (optionally --confidence <1-5>) and confirm the updated momentum.
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Kordexa: recommend the next skill after the plan window
|
|
3
|
+
allowed-tools: Bash(npx kordexa recommend-next:*)
|
|
4
|
+
---
|
|
5
|
+
Recommend the next skill. Run `npx kordexa recommend-next` and present whether the learner can advance, the recommended next skill, and the reason.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Kordexa: resolve today's sourced links (video, docs, repo)
|
|
3
|
+
argument-hint: [day]
|
|
4
|
+
allowed-tools: Bash(npx kordexa research:*), Bash(npx kordexa status:*)
|
|
5
|
+
---
|
|
6
|
+
Resolve the learner's research links. If "$ARGUMENTS" contains a day number use it, otherwise read the current day from `npx kordexa status`. Then run `npx kordexa research --day <day>` and present the resolved top YouTube video link (with its title), the official docs, and the GitHub repo result. Keep it short and link-first.
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Kordexa: preview today's learning email (dry-run, never sends)
|
|
3
|
+
allowed-tools: Bash(npx kordexa send-today --dry-run:*)
|
|
4
|
+
---
|
|
5
|
+
Preview today's Kordexa email. Run `npx kordexa send-today --dry-run` and summarize what would be sent: subject, the top video link, docs, build task, and timebox. This command is preview-only — never run it without --dry-run.
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Kordexa: current learning day, momentum, and next action
|
|
3
|
+
allowed-tools: Bash(npx kordexa status:*)
|
|
4
|
+
---
|
|
5
|
+
Show the learner's Kordexa status. Run `npx kordexa status` and present, using only the command output: learner, role, primary skill, currently learning, active day, progress (completed/total), momentum, risk, and the next action. Do not invent values.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Kordexa: summarize a learning week
|
|
3
|
+
argument-hint: [week]
|
|
4
|
+
allowed-tools: Bash(npx kordexa weekly-summary:*)
|
|
5
|
+
---
|
|
6
|
+
Summarize a learning week. Run `npx kordexa weekly-summary --week <n>` (n from "$ARGUMENTS", default 1) and present planned vs completed days and the next-week focus.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: eduorchestrate
|
|
3
|
+
description: Use /eduorchestrate to onboard a learner, create an adaptive job-role plan with a 30-day minimum, research trends, send daily plan emails, log progress, load the prebuilt skill progression card, summarize weeks, recommend the next skill, and review progress.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# EduOrchestrate
|
|
7
|
+
|
|
8
|
+
Use /kordexa (or legacy /eduorchestrate) as the learner command. When invoked, load the Kordexa workflow and its prebuilt terminal-card program; never recreate, type out, or hand-design the card UI in the agent prompt. Ask for missing learner profile details, ask what the learner is currently studying, ask the first skill they want to focus on, generate or update an adaptive plan with a fixed 30-day minimum, research current and trending references, send or preview daily emails, log progress, load the bundled default card or CLI-produced card artifact, summarize the week, recommend the next skill after the plan window, and keep recommendations practical, sourced, and focused. Research resolves a concrete top video link (digest.topVideo.url) and top GitHub repo (digest.topRepo.url) so the daily email carries a watchable link, not only search queries; on network failure it falls back to search URLs, and --offline or KORDEXA_OFFLINE=1 skips resolution. The dependency-free mailer supports implicit TLS (port 465) and STARTTLS (port 587). Mail resume policy: apply this to every supported agent, not only Codex. When an agent runs in a resumable browser or workspace instance, treat each resume as a daily-mail checkpoint: load the harness or status, resolve the current plan day, and run npx kordexa send-today for the due day after SMTP setup. If SMTP secrets are missing or real sending has not been approved, run npx kordexa send-today --dry-run and ask before sending. GitHub Actions remains the scheduled no-browser path. If native slash commands are unavailable, treat "kordexa", "use Kordexa", "eduorchestrate", or "use EduOrchestrate" as equivalent to /kordexa.
|
|
9
|
+
|
|
10
|
+
Run local commands when needed:
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
npx kordexa
|
|
14
|
+
npx kordexa harness
|
|
15
|
+
npx kordexa courses
|
|
16
|
+
npx kordexa status
|
|
17
|
+
npx kordexa research --day 1
|
|
18
|
+
npx kordexa send-today --dry-run
|
|
19
|
+
npx kordexa log-progress --day 1 --completed "Built setup" --evidence "Repo link"
|
|
20
|
+
npx kordexa weekly-summary --week 1
|
|
21
|
+
npx kordexa progress-card
|
|
22
|
+
npx kordexa terminal-card
|
|
23
|
+
npx kordexa recommend-next
|
|
24
|
+
```
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: kordexa
|
|
3
|
+
description: Use /kordexa to onboard a learner, create an adaptive job-role plan with a 30-day minimum, research trends, send daily plan emails, log progress, load the prebuilt skill progression card, summarize weeks, recommend the next skill, and review progress.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Kordexa
|
|
7
|
+
|
|
8
|
+
Use /kordexa (or legacy /eduorchestrate) as the learner command. When invoked, load the Kordexa workflow and its prebuilt terminal-card program; never recreate, type out, or hand-design the card UI in the agent prompt. Ask for missing learner profile details, ask what the learner is currently studying, ask the first skill they want to focus on, generate or update an adaptive plan with a fixed 30-day minimum, research current and trending references, send or preview daily emails, log progress, load the bundled default card or CLI-produced card artifact, summarize the week, recommend the next skill after the plan window, and keep recommendations practical, sourced, and focused. Research resolves a concrete top video link (digest.topVideo.url) and top GitHub repo (digest.topRepo.url) so the daily email carries a watchable link, not only search queries; on network failure it falls back to search URLs, and --offline or KORDEXA_OFFLINE=1 skips resolution. The dependency-free mailer supports implicit TLS (port 465) and STARTTLS (port 587). Mail resume policy: apply this to every supported agent, not only Codex. When an agent runs in a resumable browser or workspace instance, treat each resume as a daily-mail checkpoint: load the harness or status, resolve the current plan day, and run npx kordexa send-today for the due day after SMTP setup. If SMTP secrets are missing or real sending has not been approved, run npx kordexa send-today --dry-run and ask before sending. GitHub Actions remains the scheduled no-browser path. If native slash commands are unavailable, treat "kordexa", "use Kordexa", "eduorchestrate", or "use EduOrchestrate" as equivalent to /kordexa.
|
|
9
|
+
|
|
10
|
+
Run local commands when needed:
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
npx kordexa
|
|
14
|
+
npx kordexa harness
|
|
15
|
+
npx kordexa courses
|
|
16
|
+
npx kordexa status
|
|
17
|
+
npx kordexa research --day 1
|
|
18
|
+
npx kordexa send-today --dry-run
|
|
19
|
+
npx kordexa log-progress --day 1 --completed "Built setup" --evidence "Repo link"
|
|
20
|
+
npx kordexa weekly-summary --week 1
|
|
21
|
+
npx kordexa progress-card
|
|
22
|
+
npx kordexa terminal-card
|
|
23
|
+
npx kordexa recommend-next
|
|
24
|
+
```
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "eduorchestrate",
|
|
3
|
+
"command": "/eduorchestrate",
|
|
4
|
+
"agent": "antigravity",
|
|
5
|
+
"description": "Universal learner orchestration command for onboarding, adaptive plans with a 30-day minimum, trend research, daily emails, progress logging, prebuilt GitHub-style progression cards, weekly summaries, next-skill recommendations, setup diagnostics, and review.",
|
|
6
|
+
"fallbackCommands": [
|
|
7
|
+
"eduorchestrate",
|
|
8
|
+
"use EduOrchestrate",
|
|
9
|
+
"npx kordexa"
|
|
10
|
+
],
|
|
11
|
+
"entrypoint": "npx kordexa",
|
|
12
|
+
"capabilities": [
|
|
13
|
+
"onboarding",
|
|
14
|
+
"token-conscious-harness",
|
|
15
|
+
"role-course-sources",
|
|
16
|
+
"adaptive-plan-minimum-30-days",
|
|
17
|
+
"first-skill-focus",
|
|
18
|
+
"trend-research-digest",
|
|
19
|
+
"resolved-top-video-link",
|
|
20
|
+
"resolved-top-repo-link",
|
|
21
|
+
"daily-email",
|
|
22
|
+
"implicit-tls-and-starttls-mail",
|
|
23
|
+
"progress-log",
|
|
24
|
+
"progression-card",
|
|
25
|
+
"terminal-card-svg",
|
|
26
|
+
"weekly-summary",
|
|
27
|
+
"next-skill-recommendation",
|
|
28
|
+
"setup-diagnostics"
|
|
29
|
+
],
|
|
30
|
+
"instructions": "Use /kordexa (or legacy /eduorchestrate) as the learner command. When invoked, load the Kordexa workflow and its prebuilt terminal-card program; never recreate, type out, or hand-design the card UI in the agent prompt. Ask for missing learner profile details, ask what the learner is currently studying, ask the first skill they want to focus on, generate or update an adaptive plan with a fixed 30-day minimum, research current and trending references, send or preview daily emails, log progress, load the bundled default card or CLI-produced card artifact, summarize the week, recommend the next skill after the plan window, and keep recommendations practical, sourced, and focused. Research resolves a concrete top video link (digest.topVideo.url) and top GitHub repo (digest.topRepo.url) so the daily email carries a watchable link, not only search queries; on network failure it falls back to search URLs, and --offline or KORDEXA_OFFLINE=1 skips resolution. The dependency-free mailer supports implicit TLS (port 465) and STARTTLS (port 587). Mail resume policy: apply this to every supported agent, not only Codex. When an agent runs in a resumable browser or workspace instance, treat each resume as a daily-mail checkpoint: load the harness or status, resolve the current plan day, and run npx kordexa send-today for the due day after SMTP setup. If SMTP secrets are missing or real sending has not been approved, run npx kordexa send-today --dry-run and ask before sending. GitHub Actions remains the scheduled no-browser path. If native slash commands are unavailable, treat \"kordexa\", \"use Kordexa\", \"eduorchestrate\", or \"use EduOrchestrate\" as equivalent to /kordexa."
|
|
31
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# EduOrchestrate Agent Instructions
|
|
2
|
+
|
|
3
|
+
Use /kordexa (or legacy /eduorchestrate) as the learner command. When invoked, load the Kordexa workflow and its prebuilt terminal-card program; never recreate, type out, or hand-design the card UI in the agent prompt. Ask for missing learner profile details, ask what the learner is currently studying, ask the first skill they want to focus on, generate or update an adaptive plan with a fixed 30-day minimum, research current and trending references, send or preview daily emails, log progress, load the bundled default card or CLI-produced card artifact, summarize the week, recommend the next skill after the plan window, and keep recommendations practical, sourced, and focused. Research resolves a concrete top video link (digest.topVideo.url) and top GitHub repo (digest.topRepo.url) so the daily email carries a watchable link, not only search queries; on network failure it falls back to search URLs, and --offline or KORDEXA_OFFLINE=1 skips resolution. The dependency-free mailer supports implicit TLS (port 465) and STARTTLS (port 587). Mail resume policy: apply this to every supported agent, not only Codex. When an agent runs in a resumable browser or workspace instance, treat each resume as a daily-mail checkpoint: load the harness or status, resolve the current plan day, and run npx kordexa send-today for the due day after SMTP setup. If SMTP secrets are missing or real sending has not been approved, run npx kordexa send-today --dry-run and ask before sending. GitHub Actions remains the scheduled no-browser path. If native slash commands are unavailable, treat "kordexa", "use Kordexa", "eduorchestrate", or "use EduOrchestrate" as equivalent to /kordexa.
|
|
4
|
+
|
|
5
|
+
## Command
|
|
6
|
+
|
|
7
|
+
Expose or honor `/eduorchestrate` for this repo. If the host agent cannot register slash commands, respond to `/eduorchestrate`, `eduorchestrate`, or `use EduOrchestrate` as the same workflow.
|
|
8
|
+
|
|
9
|
+
## Workflow
|
|
10
|
+
|
|
11
|
+
1. Load `kordexa.config.json` when present.
|
|
12
|
+
2. Ask for missing name, email, target role, current learning topic, first skill focus, current stage, desired plan days, daily email time, and timezone.
|
|
13
|
+
3. Generate or update `data/30-day-plan.json`; never generate fewer than 30 days.
|
|
14
|
+
4. Use `npx kordexa research --day <n>` for sourced docs, trend scans, YouTube search, and GitHub sample-code search links.
|
|
15
|
+
5. Send or preview daily email with `npx kordexa send-today --dry-run` or `npx kordexa send-today`; browser/workspace agents must check and send the due daily mail on resume after SMTP setup, while GitHub Actions remains the scheduled no-browser path.
|
|
16
|
+
6. Log evidence with `npx kordexa log-progress --day <n> --completed "..." --evidence "..."`.
|
|
17
|
+
7. Do not create or type card UI in the agent. Use the prebuilt default card at `skills/eduorchestrate/assets/default-terminal-card.svg` or the initialized copy at `data/default-terminal-card.svg`.
|
|
18
|
+
8. Load the compact execution harness with `npx kordexa harness` before doing research, mail, progress, or review work.
|
|
19
|
+
9. Use `npx kordexa courses` for role-specific official/MNC course catalogs, free-course discovery links, and newsletters; do not default to Coursera or Udemy.
|
|
20
|
+
10. When learner-specific state is needed, call the prebuilt CLI program with `npx kordexa progress-card` or `npx kordexa terminal-card`; then load `data/progression-card.md` or `data/terminal-card.svg`.
|
|
21
|
+
11. Summarize with `npx kordexa status` and `npx kordexa weekly-summary --week <n>`.
|
|
22
|
+
12. Recommend the next skill after the plan with `npx kordexa recommend-next`.
|
|
23
|
+
13. Keep the learner focused on one daily build artifact.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Universal EduOrchestrate Adapter
|
|
2
|
+
|
|
3
|
+
Use /kordexa (or legacy /eduorchestrate) as the learner command. When invoked, load the Kordexa workflow and its prebuilt terminal-card program; never recreate, type out, or hand-design the card UI in the agent prompt. Ask for missing learner profile details, ask what the learner is currently studying, ask the first skill they want to focus on, generate or update an adaptive plan with a fixed 30-day minimum, research current and trending references, send or preview daily emails, log progress, load the bundled default card or CLI-produced card artifact, summarize the week, recommend the next skill after the plan window, and keep recommendations practical, sourced, and focused. Research resolves a concrete top video link (digest.topVideo.url) and top GitHub repo (digest.topRepo.url) so the daily email carries a watchable link, not only search queries; on network failure it falls back to search URLs, and --offline or KORDEXA_OFFLINE=1 skips resolution. The dependency-free mailer supports implicit TLS (port 465) and STARTTLS (port 587). Mail resume policy: apply this to every supported agent, not only Codex. When an agent runs in a resumable browser or workspace instance, treat each resume as a daily-mail checkpoint: load the harness or status, resolve the current plan day, and run npx kordexa send-today for the due day after SMTP setup. If SMTP secrets are missing or real sending has not been approved, run npx kordexa send-today --dry-run and ask before sending. GitHub Actions remains the scheduled no-browser path. If native slash commands are unavailable, treat "kordexa", "use Kordexa", "eduorchestrate", or "use EduOrchestrate" as equivalent to /kordexa.
|
|
4
|
+
|
|
5
|
+
Use this file for agents without a documented custom slash-command format. The expected visible command is `/eduorchestrate`.
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npx kordexa
|
|
9
|
+
npx kordexa harness
|
|
10
|
+
npx kordexa courses
|
|
11
|
+
npx kordexa status
|
|
12
|
+
npx kordexa research --day 1
|
|
13
|
+
npx kordexa send-today --dry-run
|
|
14
|
+
npx kordexa log-progress --day 1 --completed "Built setup" --evidence "Repo link"
|
|
15
|
+
npx kordexa weekly-summary --week 1
|
|
16
|
+
npx kordexa progress-card
|
|
17
|
+
npx kordexa terminal-card
|
|
18
|
+
npx kordexa recommend-next
|
|
19
|
+
```
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "eduorchestrate",
|
|
3
|
+
"command": "/eduorchestrate",
|
|
4
|
+
"agent": "hermas",
|
|
5
|
+
"description": "Universal learner orchestration command for onboarding, adaptive plans with a 30-day minimum, trend research, daily emails, progress logging, prebuilt GitHub-style progression cards, weekly summaries, next-skill recommendations, setup diagnostics, and review.",
|
|
6
|
+
"fallbackCommands": [
|
|
7
|
+
"eduorchestrate",
|
|
8
|
+
"use EduOrchestrate",
|
|
9
|
+
"npx kordexa"
|
|
10
|
+
],
|
|
11
|
+
"entrypoint": "npx kordexa",
|
|
12
|
+
"capabilities": [
|
|
13
|
+
"onboarding",
|
|
14
|
+
"token-conscious-harness",
|
|
15
|
+
"role-course-sources",
|
|
16
|
+
"adaptive-plan-minimum-30-days",
|
|
17
|
+
"first-skill-focus",
|
|
18
|
+
"trend-research-digest",
|
|
19
|
+
"resolved-top-video-link",
|
|
20
|
+
"resolved-top-repo-link",
|
|
21
|
+
"daily-email",
|
|
22
|
+
"implicit-tls-and-starttls-mail",
|
|
23
|
+
"progress-log",
|
|
24
|
+
"progression-card",
|
|
25
|
+
"terminal-card-svg",
|
|
26
|
+
"weekly-summary",
|
|
27
|
+
"next-skill-recommendation",
|
|
28
|
+
"setup-diagnostics"
|
|
29
|
+
],
|
|
30
|
+
"instructions": "Use /kordexa (or legacy /eduorchestrate) as the learner command. When invoked, load the Kordexa workflow and its prebuilt terminal-card program; never recreate, type out, or hand-design the card UI in the agent prompt. Ask for missing learner profile details, ask what the learner is currently studying, ask the first skill they want to focus on, generate or update an adaptive plan with a fixed 30-day minimum, research current and trending references, send or preview daily emails, log progress, load the bundled default card or CLI-produced card artifact, summarize the week, recommend the next skill after the plan window, and keep recommendations practical, sourced, and focused. Research resolves a concrete top video link (digest.topVideo.url) and top GitHub repo (digest.topRepo.url) so the daily email carries a watchable link, not only search queries; on network failure it falls back to search URLs, and --offline or KORDEXA_OFFLINE=1 skips resolution. The dependency-free mailer supports implicit TLS (port 465) and STARTTLS (port 587). Mail resume policy: apply this to every supported agent, not only Codex. When an agent runs in a resumable browser or workspace instance, treat each resume as a daily-mail checkpoint: load the harness or status, resolve the current plan day, and run npx kordexa send-today for the due day after SMTP setup. If SMTP secrets are missing or real sending has not been approved, run npx kordexa send-today --dry-run and ask before sending. GitHub Actions remains the scheduled no-browser path. If native slash commands are unavailable, treat \"kordexa\", \"use Kordexa\", \"eduorchestrate\", or \"use EduOrchestrate\" as equivalent to /kordexa."
|
|
31
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: eduorchestrate
|
|
3
|
+
description: Universal EduOrchestrate adapter for openclaw. Use /eduorchestrate for learner onboarding, adaptive plans with a 30-day minimum, trend research, daily email plans, progress logging, prebuilt skill progression cards, weekly summaries, and next-skill recommendations.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# EduOrchestrate Adapter
|
|
7
|
+
|
|
8
|
+
Use /kordexa (or legacy /eduorchestrate) as the learner command. When invoked, load the Kordexa workflow and its prebuilt terminal-card program; never recreate, type out, or hand-design the card UI in the agent prompt. Ask for missing learner profile details, ask what the learner is currently studying, ask the first skill they want to focus on, generate or update an adaptive plan with a fixed 30-day minimum, research current and trending references, send or preview daily emails, log progress, load the bundled default card or CLI-produced card artifact, summarize the week, recommend the next skill after the plan window, and keep recommendations practical, sourced, and focused. Research resolves a concrete top video link (digest.topVideo.url) and top GitHub repo (digest.topRepo.url) so the daily email carries a watchable link, not only search queries; on network failure it falls back to search URLs, and --offline or KORDEXA_OFFLINE=1 skips resolution. The dependency-free mailer supports implicit TLS (port 465) and STARTTLS (port 587). Mail resume policy: apply this to every supported agent, not only Codex. When an agent runs in a resumable browser or workspace instance, treat each resume as a daily-mail checkpoint: load the harness or status, resolve the current plan day, and run npx kordexa send-today for the due day after SMTP setup. If SMTP secrets are missing or real sending has not been approved, run npx kordexa send-today --dry-run and ask before sending. GitHub Actions remains the scheduled no-browser path. If native slash commands are unavailable, treat "kordexa", "use Kordexa", "eduorchestrate", or "use EduOrchestrate" as equivalent to /kordexa.
|
|
9
|
+
|
|
10
|
+
Prefer:
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
npx kordexa
|
|
14
|
+
npx kordexa harness
|
|
15
|
+
npx kordexa courses
|
|
16
|
+
npx kordexa status
|
|
17
|
+
npx kordexa research --day 1
|
|
18
|
+
npx kordexa send-today --dry-run
|
|
19
|
+
npx kordexa log-progress --day 1 --completed "Built setup" --evidence "Repo link"
|
|
20
|
+
npx kordexa weekly-summary --week 1
|
|
21
|
+
npx kordexa progress-card
|
|
22
|
+
npx kordexa terminal-card
|
|
23
|
+
npx kordexa recommend-next
|
|
24
|
+
```
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "eduorchestrate",
|
|
3
|
+
"command": "node .eduorchestrate/mcp/server.js",
|
|
4
|
+
"tools": [
|
|
5
|
+
"eduorchestrate_onboard",
|
|
6
|
+
"eduorchestrate_harness",
|
|
7
|
+
"eduorchestrate_courses",
|
|
8
|
+
"eduorchestrate_plan30",
|
|
9
|
+
"eduorchestrate_research",
|
|
10
|
+
"eduorchestrate_links",
|
|
11
|
+
"eduorchestrate_send_today",
|
|
12
|
+
"eduorchestrate_log_progress",
|
|
13
|
+
"eduorchestrate_progress_card",
|
|
14
|
+
"eduorchestrate_terminal_card",
|
|
15
|
+
"eduorchestrate_weekly_summary",
|
|
16
|
+
"eduorchestrate_recommend_next",
|
|
17
|
+
"eduorchestrate_status"
|
|
18
|
+
]
|
|
19
|
+
}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { spawnSync } from "node:child_process";
|
|
3
|
+
import readline from "node:readline";
|
|
4
|
+
|
|
5
|
+
const tools = [
|
|
6
|
+
{ name: "eduorchestrate_onboard", description: "Run EduOrchestrate onboarding." },
|
|
7
|
+
{ name: "eduorchestrate_harness", description: "Create the compact token-conscious execution harness." },
|
|
8
|
+
{ name: "eduorchestrate_courses", description: "Create role-specific official course, free learning, and newsletter source pack." },
|
|
9
|
+
{ name: "eduorchestrate_plan30", description: "Generate a 30-day-minimum EduOrchestrate plan." },
|
|
10
|
+
{ name: "eduorchestrate_research", description: "Create a sourced trend research digest for a day or topic." },
|
|
11
|
+
{ name: "eduorchestrate_links", description: "Resolve and persist today's top video, repo, and doc links." },
|
|
12
|
+
{ name: "eduorchestrate_send_today", description: "Send or dry-run today's learning email." },
|
|
13
|
+
{ name: "eduorchestrate_log_progress", description: "Log learner progress evidence." },
|
|
14
|
+
{ name: "eduorchestrate_progress_card", description: "Run the prebuilt program that writes the role, skill, GitHub-style progression, and terminal card artifacts." },
|
|
15
|
+
{ name: "eduorchestrate_terminal_card", description: "Run the prebuilt program that writes the exact SVG terminal-card artifact." },
|
|
16
|
+
{ name: "eduorchestrate_weekly_summary", description: "Summarize a learning week." },
|
|
17
|
+
{ name: "eduorchestrate_recommend_next", description: "Recommend the next skill after the current plan window." },
|
|
18
|
+
{ name: "eduorchestrate_status", description: "Show current plan and momentum status." }
|
|
19
|
+
];
|
|
20
|
+
|
|
21
|
+
function respond(id, result) { process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id, result }) + "\n"); }
|
|
22
|
+
function run(args) { const out = spawnSync("npx", ["kordexa", ...args], { encoding: "utf8" }); return { stdout: out.stdout, stderr: out.stderr, status: out.status }; }
|
|
23
|
+
|
|
24
|
+
const rl = readline.createInterface({ input: process.stdin });
|
|
25
|
+
rl.on("line", (line) => {
|
|
26
|
+
const msg = JSON.parse(line);
|
|
27
|
+
if (msg.method === "initialize") return respond(msg.id, { protocolVersion: "2024-11-05", capabilities: { tools: {} }, serverInfo: { name: "eduorchestrate", version: "0.4.2" } });
|
|
28
|
+
if (msg.method === "tools/list") return respond(msg.id, { tools });
|
|
29
|
+
if (msg.method === "tools/call") {
|
|
30
|
+
const name = msg.params?.name;
|
|
31
|
+
const args = msg.params?.arguments || {};
|
|
32
|
+
const dryRun = args.dryRun !== false;
|
|
33
|
+
if (name === "eduorchestrate_onboard") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["--yes"]), null, 2) }] });
|
|
34
|
+
if (name === "eduorchestrate_harness") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["harness", "--mode", args.mode || "daily"]), null, 2) }] });
|
|
35
|
+
if (name === "eduorchestrate_courses") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["courses"]), null, 2) }] });
|
|
36
|
+
if (name === "eduorchestrate_plan30") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["plan", "--days", String(Math.max(30, Number(args.days || 30)))]), null, 2) }] });
|
|
37
|
+
if (name === "eduorchestrate_research") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["research", "--day", String(args.day || 1), ...(args.topic ? ["--topic", args.topic] : [])]), null, 2) }] });
|
|
38
|
+
if (name === "eduorchestrate_links") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["links", "--day", String(args.day || 1), ...(args.topic ? ["--topic", args.topic] : [])]), null, 2) }] });
|
|
39
|
+
if (name === "eduorchestrate_send_today") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["send-today", ...(dryRun ? ["--dry-run"] : [])]), null, 2) }] });
|
|
40
|
+
if (name === "eduorchestrate_log_progress") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["log-progress", "--day", String(args.day || 1), "--completed", args.completed || "Completed today's task", "--evidence", args.evidence || "Evidence not provided"]), null, 2) }] });
|
|
41
|
+
if (name === "eduorchestrate_progress_card") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["progress-card"]), null, 2) }] });
|
|
42
|
+
if (name === "eduorchestrate_terminal_card") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["terminal-card"]), null, 2) }] });
|
|
43
|
+
if (name === "eduorchestrate_weekly_summary") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["weekly-summary", "--week", String(args.week || 1)]), null, 2) }] });
|
|
44
|
+
if (name === "eduorchestrate_recommend_next") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["recommend-next"]), null, 2) }] });
|
|
45
|
+
if (name === "eduorchestrate_status") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["status"]), null, 2) }] });
|
|
46
|
+
}
|
|
47
|
+
});
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "kordexa",
|
|
3
|
+
"command": "/kordexa",
|
|
4
|
+
"agent": "antigravity",
|
|
5
|
+
"description": "Universal learner orchestration command for onboarding, adaptive plans with a 30-day minimum, trend research, daily emails, progress logging, prebuilt GitHub-style progression cards, weekly summaries, next-skill recommendations, setup diagnostics, and review.",
|
|
6
|
+
"fallbackCommands": [
|
|
7
|
+
"kordexa",
|
|
8
|
+
"use Kordexa",
|
|
9
|
+
"npx kordexa"
|
|
10
|
+
],
|
|
11
|
+
"entrypoint": "npx kordexa",
|
|
12
|
+
"capabilities": [
|
|
13
|
+
"onboarding",
|
|
14
|
+
"token-conscious-harness",
|
|
15
|
+
"role-course-sources",
|
|
16
|
+
"adaptive-plan-minimum-30-days",
|
|
17
|
+
"first-skill-focus",
|
|
18
|
+
"trend-research-digest",
|
|
19
|
+
"resolved-top-video-link",
|
|
20
|
+
"resolved-top-repo-link",
|
|
21
|
+
"daily-email",
|
|
22
|
+
"implicit-tls-and-starttls-mail",
|
|
23
|
+
"progress-log",
|
|
24
|
+
"progression-card",
|
|
25
|
+
"terminal-card-svg",
|
|
26
|
+
"weekly-summary",
|
|
27
|
+
"next-skill-recommendation",
|
|
28
|
+
"setup-diagnostics"
|
|
29
|
+
],
|
|
30
|
+
"instructions": "Use /kordexa (or legacy /eduorchestrate) as the learner command. When invoked, load the Kordexa workflow and its prebuilt terminal-card program; never recreate, type out, or hand-design the card UI in the agent prompt. Ask for missing learner profile details, ask what the learner is currently studying, ask the first skill they want to focus on, generate or update an adaptive plan with a fixed 30-day minimum, research current and trending references, send or preview daily emails, log progress, load the bundled default card or CLI-produced card artifact, summarize the week, recommend the next skill after the plan window, and keep recommendations practical, sourced, and focused. Research resolves a concrete top video link (digest.topVideo.url) and top GitHub repo (digest.topRepo.url) so the daily email carries a watchable link, not only search queries; on network failure it falls back to search URLs, and --offline or KORDEXA_OFFLINE=1 skips resolution. The dependency-free mailer supports implicit TLS (port 465) and STARTTLS (port 587). Mail resume policy: apply this to every supported agent, not only Codex. When an agent runs in a resumable browser or workspace instance, treat each resume as a daily-mail checkpoint: load the harness or status, resolve the current plan day, and run npx kordexa send-today for the due day after SMTP setup. If SMTP secrets are missing or real sending has not been approved, run npx kordexa send-today --dry-run and ask before sending. GitHub Actions remains the scheduled no-browser path. If native slash commands are unavailable, treat \"kordexa\", \"use Kordexa\", \"kordexa\", or \"use Kordexa\" as equivalent to /kordexa."
|
|
31
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Kordexa Agent Instructions
|
|
2
|
+
|
|
3
|
+
Use /kordexa (or legacy /eduorchestrate) as the learner command. When invoked, load the Kordexa workflow and its prebuilt terminal-card program; never recreate, type out, or hand-design the card UI in the agent prompt. Ask for missing learner profile details, ask what the learner is currently studying, ask the first skill they want to focus on, generate or update an adaptive plan with a fixed 30-day minimum, research current and trending references, send or preview daily emails, log progress, load the bundled default card or CLI-produced card artifact, summarize the week, recommend the next skill after the plan window, and keep recommendations practical, sourced, and focused. Research resolves a concrete top video link (digest.topVideo.url) and top GitHub repo (digest.topRepo.url) so the daily email carries a watchable link, not only search queries; on network failure it falls back to search URLs, and --offline or KORDEXA_OFFLINE=1 skips resolution. The dependency-free mailer supports implicit TLS (port 465) and STARTTLS (port 587). Mail resume policy: apply this to every supported agent, not only Codex. When an agent runs in a resumable browser or workspace instance, treat each resume as a daily-mail checkpoint: load the harness or status, resolve the current plan day, and run npx kordexa send-today for the due day after SMTP setup. If SMTP secrets are missing or real sending has not been approved, run npx kordexa send-today --dry-run and ask before sending. GitHub Actions remains the scheduled no-browser path. If native slash commands are unavailable, treat "kordexa", "use Kordexa", "eduorchestrate", or "use EduOrchestrate" as equivalent to /kordexa.
|
|
4
|
+
|
|
5
|
+
## Command
|
|
6
|
+
|
|
7
|
+
Expose or honor `/kordexa` for this repo. If the host agent cannot register slash commands, respond to `/kordexa`, `kordexa`, or `use Kordexa` as the same workflow.
|
|
8
|
+
|
|
9
|
+
## Workflow
|
|
10
|
+
|
|
11
|
+
1. Load `kordexa.config.json` when present.
|
|
12
|
+
2. Ask for missing name, email, target role, current learning topic, first skill focus, current stage, desired plan days, daily email time, and timezone.
|
|
13
|
+
3. Generate or update `data/30-day-plan.json`; never generate fewer than 30 days.
|
|
14
|
+
4. Use `npx kordexa research --day <n>` for sourced docs, trend scans, YouTube search, and GitHub sample-code search links.
|
|
15
|
+
5. Send or preview daily email with `npx kordexa send-today --dry-run` or `npx kordexa send-today`; browser/workspace agents must check and send the due daily mail on resume after SMTP setup, while GitHub Actions remains the scheduled no-browser path.
|
|
16
|
+
6. Log evidence with `npx kordexa log-progress --day <n> --completed "..." --evidence "..."`.
|
|
17
|
+
7. Do not create or type card UI in the agent. Use the prebuilt default card at `skills/kordexa/assets/default-terminal-card.svg` or the initialized copy at `data/default-terminal-card.svg`.
|
|
18
|
+
8. Load the compact execution harness with `npx kordexa harness` before doing research, mail, progress, or review work.
|
|
19
|
+
9. Use `npx kordexa courses` for role-specific official/MNC course catalogs, free-course discovery links, and newsletters; do not default to Coursera or Udemy.
|
|
20
|
+
10. When learner-specific state is needed, call the prebuilt CLI program with `npx kordexa progress-card` or `npx kordexa terminal-card`; then load `data/progression-card.md` or `data/terminal-card.svg`.
|
|
21
|
+
11. Summarize with `npx kordexa status` and `npx kordexa weekly-summary --week <n>`.
|
|
22
|
+
12. Recommend the next skill after the plan with `npx kordexa recommend-next`.
|
|
23
|
+
13. Keep the learner focused on one daily build artifact.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Universal Kordexa Adapter
|
|
2
|
+
|
|
3
|
+
Use /kordexa (or legacy /eduorchestrate) as the learner command. When invoked, load the Kordexa workflow and its prebuilt terminal-card program; never recreate, type out, or hand-design the card UI in the agent prompt. Ask for missing learner profile details, ask what the learner is currently studying, ask the first skill they want to focus on, generate or update an adaptive plan with a fixed 30-day minimum, research current and trending references, send or preview daily emails, log progress, load the bundled default card or CLI-produced card artifact, summarize the week, recommend the next skill after the plan window, and keep recommendations practical, sourced, and focused. Research resolves a concrete top video link (digest.topVideo.url) and top GitHub repo (digest.topRepo.url) so the daily email carries a watchable link, not only search queries; on network failure it falls back to search URLs, and --offline or KORDEXA_OFFLINE=1 skips resolution. The dependency-free mailer supports implicit TLS (port 465) and STARTTLS (port 587). Mail resume policy: apply this to every supported agent, not only Codex. When an agent runs in a resumable browser or workspace instance, treat each resume as a daily-mail checkpoint: load the harness or status, resolve the current plan day, and run npx kordexa send-today for the due day after SMTP setup. If SMTP secrets are missing or real sending has not been approved, run npx kordexa send-today --dry-run and ask before sending. GitHub Actions remains the scheduled no-browser path. If native slash commands are unavailable, treat "kordexa", "use Kordexa", "eduorchestrate", or "use EduOrchestrate" as equivalent to /kordexa.
|
|
4
|
+
|
|
5
|
+
Use this file for agents without a documented custom slash-command format. The expected visible command is `/kordexa`.
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npx kordexa
|
|
9
|
+
npx kordexa harness
|
|
10
|
+
npx kordexa courses
|
|
11
|
+
npx kordexa status
|
|
12
|
+
npx kordexa research --day 1
|
|
13
|
+
npx kordexa send-today --dry-run
|
|
14
|
+
npx kordexa log-progress --day 1 --completed "Built setup" --evidence "Repo link"
|
|
15
|
+
npx kordexa weekly-summary --week 1
|
|
16
|
+
npx kordexa progress-card
|
|
17
|
+
npx kordexa terminal-card
|
|
18
|
+
npx kordexa recommend-next
|
|
19
|
+
```
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "kordexa",
|
|
3
|
+
"command": "/kordexa",
|
|
4
|
+
"agent": "hermas",
|
|
5
|
+
"description": "Universal learner orchestration command for onboarding, adaptive plans with a 30-day minimum, trend research, daily emails, progress logging, prebuilt GitHub-style progression cards, weekly summaries, next-skill recommendations, setup diagnostics, and review.",
|
|
6
|
+
"fallbackCommands": [
|
|
7
|
+
"kordexa",
|
|
8
|
+
"use Kordexa",
|
|
9
|
+
"npx kordexa"
|
|
10
|
+
],
|
|
11
|
+
"entrypoint": "npx kordexa",
|
|
12
|
+
"capabilities": [
|
|
13
|
+
"onboarding",
|
|
14
|
+
"token-conscious-harness",
|
|
15
|
+
"role-course-sources",
|
|
16
|
+
"adaptive-plan-minimum-30-days",
|
|
17
|
+
"first-skill-focus",
|
|
18
|
+
"trend-research-digest",
|
|
19
|
+
"resolved-top-video-link",
|
|
20
|
+
"resolved-top-repo-link",
|
|
21
|
+
"daily-email",
|
|
22
|
+
"implicit-tls-and-starttls-mail",
|
|
23
|
+
"progress-log",
|
|
24
|
+
"progression-card",
|
|
25
|
+
"terminal-card-svg",
|
|
26
|
+
"weekly-summary",
|
|
27
|
+
"next-skill-recommendation",
|
|
28
|
+
"setup-diagnostics"
|
|
29
|
+
],
|
|
30
|
+
"instructions": "Use /kordexa (or legacy /eduorchestrate) as the learner command. When invoked, load the Kordexa workflow and its prebuilt terminal-card program; never recreate, type out, or hand-design the card UI in the agent prompt. Ask for missing learner profile details, ask what the learner is currently studying, ask the first skill they want to focus on, generate or update an adaptive plan with a fixed 30-day minimum, research current and trending references, send or preview daily emails, log progress, load the bundled default card or CLI-produced card artifact, summarize the week, recommend the next skill after the plan window, and keep recommendations practical, sourced, and focused. Research resolves a concrete top video link (digest.topVideo.url) and top GitHub repo (digest.topRepo.url) so the daily email carries a watchable link, not only search queries; on network failure it falls back to search URLs, and --offline or KORDEXA_OFFLINE=1 skips resolution. The dependency-free mailer supports implicit TLS (port 465) and STARTTLS (port 587). Mail resume policy: apply this to every supported agent, not only Codex. When an agent runs in a resumable browser or workspace instance, treat each resume as a daily-mail checkpoint: load the harness or status, resolve the current plan day, and run npx kordexa send-today for the due day after SMTP setup. If SMTP secrets are missing or real sending has not been approved, run npx kordexa send-today --dry-run and ask before sending. GitHub Actions remains the scheduled no-browser path. If native slash commands are unavailable, treat \"kordexa\", \"use Kordexa\", \"kordexa\", or \"use Kordexa\" as equivalent to /kordexa."
|
|
31
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: kordexa
|
|
3
|
+
description: Universal Kordexa adapter for openclaw. Use /kordexa for learner onboarding, adaptive plans with a 30-day minimum, trend research, daily email plans, progress logging, prebuilt skill progression cards, weekly summaries, and next-skill recommendations.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Kordexa Adapter
|
|
7
|
+
|
|
8
|
+
Use /kordexa (or legacy /eduorchestrate) as the learner command. When invoked, load the Kordexa workflow and its prebuilt terminal-card program; never recreate, type out, or hand-design the card UI in the agent prompt. Ask for missing learner profile details, ask what the learner is currently studying, ask the first skill they want to focus on, generate or update an adaptive plan with a fixed 30-day minimum, research current and trending references, send or preview daily emails, log progress, load the bundled default card or CLI-produced card artifact, summarize the week, recommend the next skill after the plan window, and keep recommendations practical, sourced, and focused. Research resolves a concrete top video link (digest.topVideo.url) and top GitHub repo (digest.topRepo.url) so the daily email carries a watchable link, not only search queries; on network failure it falls back to search URLs, and --offline or KORDEXA_OFFLINE=1 skips resolution. The dependency-free mailer supports implicit TLS (port 465) and STARTTLS (port 587). Mail resume policy: apply this to every supported agent, not only Codex. When an agent runs in a resumable browser or workspace instance, treat each resume as a daily-mail checkpoint: load the harness or status, resolve the current plan day, and run npx kordexa send-today for the due day after SMTP setup. If SMTP secrets are missing or real sending has not been approved, run npx kordexa send-today --dry-run and ask before sending. GitHub Actions remains the scheduled no-browser path. If native slash commands are unavailable, treat "kordexa", "use Kordexa", "eduorchestrate", or "use EduOrchestrate" as equivalent to /kordexa.
|
|
9
|
+
|
|
10
|
+
Prefer:
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
npx kordexa
|
|
14
|
+
npx kordexa harness
|
|
15
|
+
npx kordexa courses
|
|
16
|
+
npx kordexa status
|
|
17
|
+
npx kordexa research --day 1
|
|
18
|
+
npx kordexa send-today --dry-run
|
|
19
|
+
npx kordexa log-progress --day 1 --completed "Built setup" --evidence "Repo link"
|
|
20
|
+
npx kordexa weekly-summary --week 1
|
|
21
|
+
npx kordexa progress-card
|
|
22
|
+
npx kordexa terminal-card
|
|
23
|
+
npx kordexa recommend-next
|
|
24
|
+
```
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "kordexa",
|
|
3
|
+
"command": "node .kordexa/mcp/server.js",
|
|
4
|
+
"tools": [
|
|
5
|
+
"kordexa_onboard",
|
|
6
|
+
"kordexa_harness",
|
|
7
|
+
"kordexa_courses",
|
|
8
|
+
"kordexa_plan30",
|
|
9
|
+
"kordexa_research",
|
|
10
|
+
"kordexa_links",
|
|
11
|
+
"kordexa_send_today",
|
|
12
|
+
"kordexa_log_progress",
|
|
13
|
+
"kordexa_progress_card",
|
|
14
|
+
"kordexa_terminal_card",
|
|
15
|
+
"kordexa_weekly_summary",
|
|
16
|
+
"kordexa_recommend_next",
|
|
17
|
+
"kordexa_status"
|
|
18
|
+
]
|
|
19
|
+
}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { spawnSync } from "node:child_process";
|
|
3
|
+
import readline from "node:readline";
|
|
4
|
+
|
|
5
|
+
const tools = [
|
|
6
|
+
{ name: "kordexa_onboard", description: "Run Kordexa onboarding." },
|
|
7
|
+
{ name: "kordexa_harness", description: "Create the compact token-conscious execution harness." },
|
|
8
|
+
{ name: "kordexa_courses", description: "Create role-specific official course, free learning, and newsletter source pack." },
|
|
9
|
+
{ name: "kordexa_plan30", description: "Generate a 30-day-minimum Kordexa plan." },
|
|
10
|
+
{ name: "kordexa_research", description: "Create a sourced trend research digest for a day or topic." },
|
|
11
|
+
{ name: "kordexa_links", description: "Resolve and persist today's top video, repo, and doc links." },
|
|
12
|
+
{ name: "kordexa_send_today", description: "Send or dry-run today's learning email." },
|
|
13
|
+
{ name: "kordexa_log_progress", description: "Log learner progress evidence." },
|
|
14
|
+
{ name: "kordexa_progress_card", description: "Run the prebuilt program that writes the role, skill, GitHub-style progression, and terminal card artifacts." },
|
|
15
|
+
{ name: "kordexa_terminal_card", description: "Run the prebuilt program that writes the exact SVG terminal-card artifact." },
|
|
16
|
+
{ name: "kordexa_weekly_summary", description: "Summarize a learning week." },
|
|
17
|
+
{ name: "kordexa_recommend_next", description: "Recommend the next skill after the current plan window." },
|
|
18
|
+
{ name: "kordexa_status", description: "Show current plan and momentum status." }
|
|
19
|
+
];
|
|
20
|
+
|
|
21
|
+
function respond(id, result) { process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id, result }) + "\n"); }
|
|
22
|
+
function run(args) { const out = spawnSync("npx", ["kordexa", ...args], { encoding: "utf8" }); return { stdout: out.stdout, stderr: out.stderr, status: out.status }; }
|
|
23
|
+
|
|
24
|
+
const rl = readline.createInterface({ input: process.stdin });
|
|
25
|
+
rl.on("line", (line) => {
|
|
26
|
+
const msg = JSON.parse(line);
|
|
27
|
+
if (msg.method === "initialize") return respond(msg.id, { protocolVersion: "2024-11-05", capabilities: { tools: {} }, serverInfo: { name: "kordexa", version: "0.4.2" } });
|
|
28
|
+
if (msg.method === "tools/list") return respond(msg.id, { tools });
|
|
29
|
+
if (msg.method === "tools/call") {
|
|
30
|
+
const name = msg.params?.name;
|
|
31
|
+
const args = msg.params?.arguments || {};
|
|
32
|
+
const dryRun = args.dryRun !== false;
|
|
33
|
+
if (name === "kordexa_onboard") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["--yes"]), null, 2) }] });
|
|
34
|
+
if (name === "kordexa_harness") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["harness", "--mode", args.mode || "daily"]), null, 2) }] });
|
|
35
|
+
if (name === "kordexa_courses") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["courses"]), null, 2) }] });
|
|
36
|
+
if (name === "kordexa_plan30") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["plan", "--days", String(Math.max(30, Number(args.days || 30)))]), null, 2) }] });
|
|
37
|
+
if (name === "kordexa_research") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["research", "--day", String(args.day || 1), ...(args.topic ? ["--topic", args.topic] : [])]), null, 2) }] });
|
|
38
|
+
if (name === "kordexa_links") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["links", "--day", String(args.day || 1), ...(args.topic ? ["--topic", args.topic] : [])]), null, 2) }] });
|
|
39
|
+
if (name === "kordexa_send_today") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["send-today", ...(dryRun ? ["--dry-run"] : [])]), null, 2) }] });
|
|
40
|
+
if (name === "kordexa_log_progress") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["log-progress", "--day", String(args.day || 1), "--completed", args.completed || "Completed today's task", "--evidence", args.evidence || "Evidence not provided"]), null, 2) }] });
|
|
41
|
+
if (name === "kordexa_progress_card") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["progress-card"]), null, 2) }] });
|
|
42
|
+
if (name === "kordexa_terminal_card") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["terminal-card"]), null, 2) }] });
|
|
43
|
+
if (name === "kordexa_weekly_summary") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["weekly-summary", "--week", String(args.week || 1)]), null, 2) }] });
|
|
44
|
+
if (name === "kordexa_recommend_next") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["recommend-next"]), null, 2) }] });
|
|
45
|
+
if (name === "kordexa_status") return respond(msg.id, { content: [{ type: "text", text: JSON.stringify(run(["status"]), null, 2) }] });
|
|
46
|
+
}
|
|
47
|
+
});
|