@jstn-sdk/rcs 0.1.6 → 0.1.8
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 +64 -1
- package/dist/agents/definitions.d.ts +6 -0
- package/dist/agents/definitions.d.ts.map +1 -1
- package/dist/agents/definitions.js +14 -0
- package/dist/agents/definitions.js.map +1 -1
- package/dist/config/generator.d.ts.map +1 -1
- package/dist/config/generator.js +6 -2
- package/dist/config/generator.js.map +1 -1
- package/dist/config/models.d.ts +37 -0
- package/dist/config/models.d.ts.map +1 -1
- package/dist/config/models.js +121 -3
- package/dist/config/models.js.map +1 -1
- package/dist/config/roblox-reference-mcp.d.ts +16 -0
- package/dist/config/roblox-reference-mcp.d.ts.map +1 -0
- package/dist/config/roblox-reference-mcp.js +37 -0
- package/dist/config/roblox-reference-mcp.js.map +1 -0
- package/dist/index.d.ts +3 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/platform-targets/reader.d.ts +3 -0
- package/dist/platform-targets/reader.d.ts.map +1 -0
- package/dist/platform-targets/reader.js +31 -0
- package/dist/platform-targets/reader.js.map +1 -0
- package/dist/platform-targets/schema.d.ts +22 -0
- package/dist/platform-targets/schema.d.ts.map +1 -0
- package/dist/platform-targets/schema.js +88 -0
- package/dist/platform-targets/schema.js.map +1 -0
- package/dist/scripts/publish-github-package.d.ts +3 -0
- package/dist/scripts/publish-github-package.d.ts.map +1 -0
- package/dist/scripts/publish-github-package.js +74 -0
- package/dist/scripts/publish-github-package.js.map +1 -0
- package/dist/scripts/surface-taxonomy.d.ts.map +1 -1
- package/dist/scripts/surface-taxonomy.js +0 -5
- package/dist/scripts/surface-taxonomy.js.map +1 -1
- package/docs/agents.html +1 -0
- package/docs/index.html +13 -1
- package/docs/plugin-bundle-ssot.md +2 -0
- package/docs/readme/README.de.md +46 -19
- package/docs/readme/README.el.md +47 -20
- package/docs/readme/README.es.md +47 -20
- package/docs/readme/README.fr.md +47 -20
- package/docs/readme/README.it.md +46 -19
- package/docs/readme/README.ja.md +47 -20
- package/docs/readme/README.ko.md +47 -20
- package/docs/readme/README.md +2 -1
- package/docs/readme/README.pl.md +47 -20
- package/docs/readme/README.pt.md +47 -20
- package/docs/readme/README.ru.md +47 -20
- package/docs/readme/README.tr.md +47 -20
- package/docs/readme/README.uk.md +47 -20
- package/docs/readme/README.vi.md +47 -20
- package/docs/readme/README.zh-TW.md +47 -20
- package/docs/readme/README.zh.md +47 -20
- package/docs/reference/agentic-platform-compatibility.md +147 -0
- package/docs/reference/canonical-vocabulary.md +0 -1
- package/docs/reference/llm-provider-abstraction.md +88 -0
- package/docs/reference/multi-agent-compatibility-architecture.md +120 -0
- package/docs/reference/rcs-config-schema-routing.md +3 -0
- package/docs/reference/roblox-mcp-reference-layer.md +75 -0
- package/docs/reference/roblox-pre-action-protocol.md +15 -3
- package/docs/reference/semantic-design-system.md +0 -7
- package/docs/reference/surface-map.md +0 -9
- package/docs/release-notes-v0.1.7.md +20 -0
- package/docs/release-notes-v0.1.8.md +24 -0
- package/docs/wiki/Contributing.md +45 -0
- package/docs/wiki/Good-First-Issues.md +44 -0
- package/docs/wiki/Home.md +35 -0
- package/docs/wiki/Release-Playbook.md +57 -0
- package/docs/wiki/Roadmap.md +90 -0
- package/package.json +1 -1
- package/plugins/roblox-ai-os-creator-skills/.codex-plugin/plugin.json +1 -1
- package/plugins/roblox-ai-os-creator-skills/docs/reference/roblox-pre-action-protocol.md +15 -3
- package/plugins/roblox-ai-os-creator-skills/skills/ai-slop-cleaner/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/analyze/SKILL.md +6 -9
- package/plugins/roblox-ai-os-creator-skills/skills/ask-claude/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/ask-gemini/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/autoforge/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/autopilot/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/autoresearch/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/blueprint/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/blueprint-loop/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/blueprint-psych/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/blueprint-retention/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/blueprint-social/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/brief/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/brief-audience/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/brief-motivation/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/cancel/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/code-review/SKILL.md +6 -9
- package/plugins/roblox-ai-os-creator-skills/skills/configure-notifications/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/crew/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/deep-interview/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/doctor/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/forge/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/forge-community/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/forge-daily-loop/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/forge-event-loop/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/forge-fomo/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/forge-mastery/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/forge-progression/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/forge-reward-loop/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/forge-status/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/help/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/hud/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/note/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/pipeline/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/plan/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/rcs-setup/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/security-review/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/skill/SKILL.md +38 -40
- package/plugins/roblox-ai-os-creator-skills/skills/team/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/trace/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/ultraqa/SKILL.md +7 -10
- package/plugins/roblox-ai-os-creator-skills/skills/ultrawork/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/visual-forge/SKILL.md +1 -4
- package/plugins/roblox-ai-os-creator-skills/skills/visual-verdict/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/wiki/SKILL.md +0 -3
- package/plugins/roblox-ai-os-creator-skills/skills/worker/SKILL.md +1 -4
- package/prompts/analyst.md +3 -6
- package/prompts/architect.md +2 -4
- package/prompts/build-fixer.md +5 -5
- package/prompts/code-reviewer.md +3 -4
- package/prompts/critic.md +0 -3
- package/prompts/debugger.md +4 -6
- package/prompts/dependency-expert.md +1 -3
- package/prompts/designer.md +2 -5
- package/prompts/executor.md +2 -4
- package/prompts/explore-harness.md +0 -3
- package/prompts/explore.md +1 -4
- package/prompts/git-master.md +0 -3
- package/prompts/planner.md +2 -4
- package/prompts/researcher.md +2 -5
- package/prompts/security-reviewer.md +2 -4
- package/prompts/sisyphus-lite.md +0 -3
- package/prompts/team-executor.md +1 -3
- package/prompts/test-engineer.md +6 -8
- package/prompts/verifier.md +1 -3
- package/prompts/vision.md +1 -3
- package/prompts/writer.md +3 -5
- package/skills/ai-slop-cleaner/SKILL.md +0 -3
- package/skills/analyze/SKILL.md +6 -9
- package/skills/ask-claude/SKILL.md +0 -3
- package/skills/ask-gemini/SKILL.md +0 -3
- package/skills/autoforge/SKILL.md +0 -3
- package/skills/autopilot/SKILL.md +0 -3
- package/skills/autoresearch/SKILL.md +0 -3
- package/skills/blueprint/SKILL.md +0 -3
- package/skills/blueprint-loop/SKILL.md +0 -3
- package/skills/blueprint-psych/SKILL.md +0 -3
- package/skills/blueprint-retention/SKILL.md +0 -3
- package/skills/blueprint-social/SKILL.md +0 -3
- package/skills/brief/SKILL.md +0 -3
- package/skills/brief-audience/SKILL.md +0 -3
- package/skills/brief-motivation/SKILL.md +0 -3
- package/skills/build-fix/SKILL.md +2 -4
- package/skills/cancel/SKILL.md +0 -3
- package/skills/code-review/SKILL.md +6 -9
- package/skills/configure-notifications/SKILL.md +0 -3
- package/skills/crew/SKILL.md +0 -3
- package/skills/deep-interview/SKILL.md +0 -3
- package/skills/deepsearch/SKILL.md +0 -3
- package/skills/doctor/SKILL.md +0 -3
- package/skills/ecomode/SKILL.md +0 -3
- package/skills/forge/SKILL.md +0 -3
- package/skills/forge-community/SKILL.md +0 -3
- package/skills/forge-daily-loop/SKILL.md +0 -3
- package/skills/forge-event-loop/SKILL.md +0 -3
- package/skills/forge-fomo/SKILL.md +0 -3
- package/skills/forge-init/SKILL.md +0 -3
- package/skills/forge-mastery/SKILL.md +0 -3
- package/skills/forge-progression/SKILL.md +0 -3
- package/skills/forge-reward-loop/SKILL.md +0 -3
- package/skills/forge-status/SKILL.md +0 -3
- package/skills/git-master/SKILL.md +0 -3
- package/skills/help/SKILL.md +0 -3
- package/skills/hud/SKILL.md +0 -3
- package/skills/note/SKILL.md +0 -3
- package/skills/pipeline/SKILL.md +0 -3
- package/skills/plan/SKILL.md +0 -3
- package/skills/rcs-setup/SKILL.md +0 -3
- package/skills/review/SKILL.md +0 -3
- package/skills/security-review/SKILL.md +0 -3
- package/skills/skill/SKILL.md +38 -40
- package/skills/swarm/SKILL.md +1 -4
- package/skills/tdd/SKILL.md +0 -3
- package/skills/team/SKILL.md +0 -3
- package/skills/trace/SKILL.md +0 -3
- package/skills/ultraqa/SKILL.md +7 -10
- package/skills/ultrawork/SKILL.md +0 -3
- package/skills/visual-forge/SKILL.md +1 -4
- package/skills/visual-verdict/SKILL.md +0 -3
- package/skills/web-clone/SKILL.md +0 -3
- package/skills/wiki/SKILL.md +0 -3
- package/skills/worker/SKILL.md +1 -4
- package/src/scripts/publish-github-package.ts +94 -0
- package/src/scripts/surface-taxonomy.ts +0 -5
- package/templates/roblox/llm-provider-routing.json +42 -0
- package/templates/roblox/reference-sources.md +33 -0
- package/docs/archive/README.md +0 -15
- package/docs/archive/migration-mainline-post-v0.4.4.md +0 -90
- package/docs/archive/prompt-migration-changelog.md +0 -141
- package/docs/archive/qa-plan-0.4.2.md +0 -85
- package/docs/archive/qa-report-0.4.2.md +0 -55
- package/docs/archive/release-body-0.9.0.md +0 -86
- package/docs/archive/release-body-0.9.1.md +0 -41
- package/docs/benchmarks/tetris-benchmark-comparison-20260306.png +0 -0
- package/docs/issues/team-forge-followup-team.md +0 -38
- package/docs/qa/ci-speedups-after-prompt-worker-fix.md +0 -91
- package/docs/qa/deep-interview-phase-1-validation.md +0 -117
- package/docs/qa/explore-sparkshell-heavy-manual-stress.md +0 -244
- package/docs/qa/recent-bug-regression-hardening-2026-04-11.md +0 -24
- package/docs/qa/release-no-publish-0.15.0.md +0 -33
- package/docs/qa/release-readiness-0.11.13.md +0 -39
- package/docs/qa/release-readiness-0.12.0.md +0 -80
- package/docs/qa/release-readiness-0.12.1.md +0 -33
- package/docs/qa/release-readiness-0.12.2.md +0 -33
- package/docs/qa/release-readiness-0.12.3.md +0 -30
- package/docs/qa/release-readiness-0.12.5.md +0 -69
- package/docs/qa/release-readiness-0.12.6.md +0 -59
- package/docs/qa/release-readiness-0.13.0.md +0 -64
- package/docs/qa/release-readiness-0.13.1.md +0 -39
- package/docs/qa/release-readiness-0.14.0.md +0 -55
- package/docs/qa/release-readiness-0.14.1.md +0 -44
- package/docs/qa/release-readiness-0.14.2.md +0 -65
- package/docs/qa/release-readiness-0.14.3.md +0 -42
- package/docs/qa/release-readiness-0.14.4.md +0 -40
- package/docs/qa/release-readiness-0.15.0.md +0 -65
- package/docs/qa/release-readiness-0.15.1.md +0 -44
- package/docs/qa/release-readiness-0.8.1.md +0 -37
- package/docs/qa/release-readiness-0.8.2.md +0 -39
- package/docs/qa/release-readiness-0.8.3.md +0 -43
- package/docs/qa/release-readiness-0.8.4.md +0 -39
- package/docs/qa/release-readiness-0.9.0.md +0 -78
- package/docs/qa/release-readiness-0.9.1.md +0 -43
- package/docs/qa/release-readiness-follow-up.md +0 -26
- package/docs/qa/remaining-suite-drift-2026-03-19.md +0 -105
- package/docs/qa/research-specialist-eval-surface-2026-04-18.md +0 -42
- package/docs/qa/runtime-team-seam-audit-2026-04-01.md +0 -128
- package/docs/reports/macos-m1-high-cpu-usage-2026-04-16.md +0 -78
- package/docs/reports/open-prs-dev-readiness-2026-04-09.md +0 -45
|
@@ -260,14 +260,9 @@ export function buildSurfaceMapMarkdown(records: SurfaceTaxonomyRecord[]): strin
|
|
|
260
260
|
'',
|
|
261
261
|
...renderTable(internal),
|
|
262
262
|
'',
|
|
263
|
-
'## Historical Surfaces',
|
|
264
|
-
'',
|
|
265
|
-
...renderTable(historical),
|
|
266
|
-
'',
|
|
267
263
|
'## Additional Repo Lanes',
|
|
268
264
|
'',
|
|
269
265
|
'- `AGENTS.md` and `templates/AGENTS.md` remain the orchestration brain and guidance authority.',
|
|
270
|
-
'- `docs/archive/` is the historical lane; archive content may describe removed surfaces but must not act as active onboarding.',
|
|
271
266
|
'- `src/catalog/manifest.json`, `templates/catalog-manifest.json`, and `src/catalog/generated/public-catalog.json` are the catalog source/generated contract lane.',
|
|
272
267
|
'- `dist/` is generated runtime output and should reflect the taxonomy, not redefine it.',
|
|
273
268
|
'',
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
{
|
|
2
|
+
"providers": {
|
|
3
|
+
"openrouter": {
|
|
4
|
+
"base_url": "https://openrouter.ai/api/v1",
|
|
5
|
+
"api_format": "openai-compatible",
|
|
6
|
+
"env_key": "OPENROUTER_API_KEY",
|
|
7
|
+
"capabilities": [
|
|
8
|
+
"chat",
|
|
9
|
+
"reasoning"
|
|
10
|
+
],
|
|
11
|
+
"label": "OpenRouter"
|
|
12
|
+
},
|
|
13
|
+
"anthropic_proxy": {
|
|
14
|
+
"base_url": "https://proxy.example.com/anthropic",
|
|
15
|
+
"api_format": "anthropic",
|
|
16
|
+
"env_key": "ANTHROPIC_PROXY_KEY",
|
|
17
|
+
"capabilities": [
|
|
18
|
+
"chat",
|
|
19
|
+
"long-context"
|
|
20
|
+
],
|
|
21
|
+
"label": "Anthropic Proxy"
|
|
22
|
+
}
|
|
23
|
+
},
|
|
24
|
+
"routing": {
|
|
25
|
+
"default_provider": "openrouter",
|
|
26
|
+
"mode_providers": {
|
|
27
|
+
"forge": "openrouter",
|
|
28
|
+
"team": "anthropic_proxy"
|
|
29
|
+
},
|
|
30
|
+
"fallback_providers": [
|
|
31
|
+
"openrouter"
|
|
32
|
+
],
|
|
33
|
+
"mode_fallback_providers": {
|
|
34
|
+
"forge": [
|
|
35
|
+
"openrouter",
|
|
36
|
+
"anthropic_proxy"
|
|
37
|
+
]
|
|
38
|
+
},
|
|
39
|
+
"hot_swap": true,
|
|
40
|
+
"failover": true
|
|
41
|
+
}
|
|
42
|
+
}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Roblox Reference Sources
|
|
2
|
+
|
|
3
|
+
Use this inventory when a Roblox task needs external grounding before implementation.
|
|
4
|
+
|
|
5
|
+
## Official platform truth
|
|
6
|
+
|
|
7
|
+
- `https://github.com/Roblox/creator-docs`
|
|
8
|
+
- `https://gitmcp.io/Roblox/creator-docs`
|
|
9
|
+
|
|
10
|
+
## Roblox implementation guidance
|
|
11
|
+
|
|
12
|
+
- `https://github.com/sentinelcore/roblox-skills`
|
|
13
|
+
- `https://gitmcp.io/sentinelcore/roblox-skills`
|
|
14
|
+
- `https://github.com/greedychipmunk/agent-skills/tree/main/roblox-game-developer`
|
|
15
|
+
- `https://github.com/omer-metin/skills-for-antigravity/tree/main/skills/roblox-development`
|
|
16
|
+
- `https://github.com/dig1t/skills`
|
|
17
|
+
- `https://github.com/Corecii/Devprod`
|
|
18
|
+
- `https://gitmcp.io/Corecii/Devprod`
|
|
19
|
+
|
|
20
|
+
## Raw script / corpus support
|
|
21
|
+
|
|
22
|
+
- `https://github.com/retpirato/Roblox-Scripts`
|
|
23
|
+
- `https://gitmcp.io/retpirato/Roblox-Scripts`
|
|
24
|
+
- `https://gitmcp.io/frosteen/Roblox_LUA_Weapon_Scripts`
|
|
25
|
+
- `https://gitmcp.io/uhub/awesome-lua`
|
|
26
|
+
- `https://gitmcp.io/LewisJEllis/awesome-lua`
|
|
27
|
+
- `https://gitmcp.io/forhappy/awesome-lua`
|
|
28
|
+
- `http://lua-users.org/wiki/SampleCode`
|
|
29
|
+
|
|
30
|
+
Rules:
|
|
31
|
+
- official docs define correctness
|
|
32
|
+
- skill repos improve implementation awareness
|
|
33
|
+
- corpora are not trusted production code
|
package/docs/archive/README.md
DELETED
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
# Archive Docs
|
|
2
|
-
|
|
3
|
-
This directory holds historical or migration-only collateral that is **not** part of the active
|
|
4
|
-
RCS product surface.
|
|
5
|
-
|
|
6
|
-
Archive docs may include:
|
|
7
|
-
- migration changelogs
|
|
8
|
-
- old release-body collateral
|
|
9
|
-
- transitional QA snapshots
|
|
10
|
-
- historical restructuring notes
|
|
11
|
-
|
|
12
|
-
Rules:
|
|
13
|
-
- do not use archive docs as active onboarding or canonical runtime guidance
|
|
14
|
-
- if a file in `docs/archive/` is still needed by active runtime/code/tests, it should move back out
|
|
15
|
-
- active source-of-truth docs stay under the main `docs/`, `docs/reference/`, `docs/contracts/`, and `docs/qa/` surfaces
|
|
@@ -1,90 +0,0 @@
|
|
|
1
|
-
# Migration Guide: post-v0.4.4 mainline changes
|
|
2
|
-
|
|
3
|
-
This guide covers migration from **v0.4.4** to the current mainline changes merged after it (including PR #137 and follow-up fixes).
|
|
4
|
-
|
|
5
|
-
## Who is affected
|
|
6
|
-
|
|
7
|
-
You are affected if you:
|
|
8
|
-
|
|
9
|
-
- invoke removed prompts or skills from old notes/scripts,
|
|
10
|
-
- depend on pre-consolidation catalog names,
|
|
11
|
-
- use `rcs setup` and need predictable install scope behavior,
|
|
12
|
-
- run `rcs team`/tmux workflows and want the latest reliability fixes,
|
|
13
|
-
- use notifier output and need verbosity control.
|
|
14
|
-
|
|
15
|
-
## What changed (high level)
|
|
16
|
-
|
|
17
|
-
- Catalog consolidation for prompts/skills and cleanup of deprecated entries.
|
|
18
|
-
- `rcs setup` now supports scope-aware install modes (`user`, `project`). Legacy `project-local` values are auto-migrated.
|
|
19
|
-
- Spark worker routing added for team workers (`--spark`, `--madmax-spark`).
|
|
20
|
-
- Notifier verbosity controls added.
|
|
21
|
-
- tmux runtime hardening updates landed, including post-review pane capture/input hardening.
|
|
22
|
-
- Stale references to removed `scientist`/`pipeline` were cleaned up.
|
|
23
|
-
|
|
24
|
-
## Removed prompts and skills
|
|
25
|
-
|
|
26
|
-
### Removed prompts
|
|
27
|
-
|
|
28
|
-
- `deep-executor`
|
|
29
|
-
- `scientist`
|
|
30
|
-
|
|
31
|
-
### Removed skills
|
|
32
|
-
|
|
33
|
-
- `deepinit`
|
|
34
|
-
- `learn-about-rcs`
|
|
35
|
-
- `learner`
|
|
36
|
-
- `pipeline`
|
|
37
|
-
- `project-session-manager`
|
|
38
|
-
- `psm`
|
|
39
|
-
- `release`
|
|
40
|
-
- `ultrapilot`
|
|
41
|
-
- `writer-memory`
|
|
42
|
-
|
|
43
|
-
## Mapping old references to current ones
|
|
44
|
-
|
|
45
|
-
Use these replacements in docs, scripts, and personal shortcuts.
|
|
46
|
-
|
|
47
|
-
| Old reference | Use now | Notes |
|
|
48
|
-
|---|---|---|
|
|
49
|
-
| `/prompts:deep-executor` | `/prompts:executor` | `deep-executor` was a deprecated alias to executor behavior. |
|
|
50
|
-
| `/prompts:scientist` | `/prompts:researcher` | Use researcher for research-focused workflows in current catalog. |
|
|
51
|
-
| `$pipeline` | `$team` (or explicit `/prompts:*` sequencing) | Team is the default orchestrator pipeline surface. |
|
|
52
|
-
| `$ultrapilot` | `$team` | Use team-based parallel orchestration. |
|
|
53
|
-
| `$psm` / `$project-session-manager` | No in-repo replacement | Remove from automation or maintain out-of-tree tooling. |
|
|
54
|
-
| `$release` | No in-repo replacement | Use your project release process directly. |
|
|
55
|
-
| `$deepinit` | `rcs agents-init [path]` | Lightweight CLI successor for AGENTS.md bootstrap only; immediate child directories only, unmanaged files preserved unless `--force`. |
|
|
56
|
-
| `$learn-about-rcs` / `$learner` / `$writer-memory` | No in-repo replacement | Remove stale references from workflows/docs. |
|
|
57
|
-
|
|
58
|
-
## Verification checklist after upgrade
|
|
59
|
-
|
|
60
|
-
Run this checklist after pulling latest mainline:
|
|
61
|
-
|
|
62
|
-
- [ ] Confirm removed references are gone from local notes/scripts:
|
|
63
|
-
```bash
|
|
64
|
-
rg -n "deep-executor|scientist|pipeline|project-session-manager|\bpsm\b|ultrapilot|learn-about-rcs|writer-memory|learner|deepinit|\brelease\b" README.md docs scripts .rcs -S
|
|
65
|
-
```
|
|
66
|
-
- [ ] Confirm current prompt catalog no longer contains removed prompts:
|
|
67
|
-
```bash
|
|
68
|
-
ls prompts
|
|
69
|
-
```
|
|
70
|
-
- [ ] Confirm current skill catalog no longer contains removed skills:
|
|
71
|
-
```bash
|
|
72
|
-
ls skills
|
|
73
|
-
```
|
|
74
|
-
- [ ] Validate setup scope options are available:
|
|
75
|
-
```bash
|
|
76
|
-
rcs help | rg -e "--scope|project"
|
|
77
|
-
```
|
|
78
|
-
- [ ] Validate team/tmux health checks:
|
|
79
|
-
```bash
|
|
80
|
-
rcs doctor --team
|
|
81
|
-
```
|
|
82
|
-
- [ ] If using spark worker routing, verify flags are available:
|
|
83
|
-
```bash
|
|
84
|
-
rcs --help | rg "spark|madmax-spark"
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
## Related docs
|
|
88
|
-
|
|
89
|
-
- Release notes: [CHANGELOG.md](../CHANGELOG.md)
|
|
90
|
-
- Main overview: [README.md](../README.md)
|
|
@@ -1,141 +0,0 @@
|
|
|
1
|
-
# Prompt Migration Changelog
|
|
2
|
-
|
|
3
|
-
## Scope
|
|
4
|
-
|
|
5
|
-
- Migration window: `e21cb5e` -> `ff7ee14`
|
|
6
|
-
- Surface: `prompts/*.md` (30 files)
|
|
7
|
-
- Goal: document the prior XML-to-Markdown migration while reaffirming that prompt files remain the canonical XML-tagged subagent role surfaces for RCS.
|
|
8
|
-
|
|
9
|
-
## Global Changes (Applied to All Prompt Files)
|
|
10
|
-
|
|
11
|
-
- Preserved frontmatter metadata (`description`, `argument-hint`).
|
|
12
|
-
- Replaced wrapper tags such as `<Agent_Prompt>`, `<Role>`, `<Constraints>`, `<Output_Format>`, `<Final_Checklist>` with Markdown section headings.
|
|
13
|
-
- Flattened nested XML-like sections into readable Markdown bullets/numbered steps.
|
|
14
|
-
- Kept role semantics, tool usage intent, guardrails, and checklist expectations functionally equivalent.
|
|
15
|
-
- Important current-state clarification: although the prompt text is now Markdown-first, each file in `prompts/*.md` is still the canonical XML-tagged subagent role surface consumed by RCS install/generation flows.
|
|
16
|
-
|
|
17
|
-
## Behavior Notes
|
|
18
|
-
|
|
19
|
-
- No intentionally introduced functional behavior changes were made in this migration commit.
|
|
20
|
-
- Behavior-relevant content (constraints, verification expectations, output templates) was preserved while syntax/formatting was normalized.
|
|
21
|
-
- Any post-migration behavior differences are expected to come from readability and parser-compatibility improvements, not policy changes.
|
|
22
|
-
|
|
23
|
-
## Per-File Matrix
|
|
24
|
-
|
|
25
|
-
| Prompt File | Added | Removed | Structural Highlights | Behavior Delta |
|
|
26
|
-
|---|---:|---:|---|---|
|
|
27
|
-
| `prompts/analyst.md` | 102 | 105 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
28
|
-
| `prompts/architect.md` | 102 | 104 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
29
|
-
| `prompts/build-fixer.md` | 81 | 84 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
30
|
-
| `prompts/code-reviewer.md` | 98 | 100 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
31
|
-
| `prompts/critic.md` | 79 | 82 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
32
|
-
| `prompts/debugger.md` | 85 | 88 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
33
|
-
| `prompts/deep-executor.md` | 105 | 107 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
34
|
-
| `prompts/dependency-expert.md` | 91 | 94 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
35
|
-
| `prompts/designer.md` | 96 | 98 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
36
|
-
| `prompts/executor.md` | 92 | 94 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
37
|
-
| `prompts/explore.md` | 104 | 107 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
38
|
-
| `prompts/git-master.md` | 84 | 87 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
39
|
-
| `prompts/planner.md` | 108 | 111 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
40
|
-
| `prompts/researcher.md` | 88 | 91 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
41
|
-
| `prompts/scientist.md` | 84 | 87 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
42
|
-
| `prompts/security-reviewer.md` | 119 | 121 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
43
|
-
| `prompts/test-engineer.md` | 96 | 98 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
44
|
-
| `prompts/verifier.md` | 87 | 90 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
45
|
-
| `prompts/vision.md` | 67 | 70 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
46
|
-
| `prompts/writer.md` | 78 | 81 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
|
|
47
|
-
|
|
48
|
-
## Validation
|
|
49
|
-
|
|
50
|
-
- Commit diff summary: `30 files changed, 2439 insertions(+), 2511 deletions(-)`
|
|
51
|
-
- Spot-checks performed on role-heavy prompts (`planner`, `executor`, `explore`) confirmed semantic parity with formatting normalization.
|
|
52
|
-
|
|
53
|
-
---
|
|
54
|
-
|
|
55
|
-
## Orchestration Brain Migration (`AGENTS.md`, `templates/AGENTS.md`)
|
|
56
|
-
|
|
57
|
-
### Summary
|
|
58
|
-
|
|
59
|
-
These files are the instruction root that RCS expects Codex to follow across a workspace.
|
|
60
|
-
Changes here are primarily about aligning instructions with Codex CLI tool contracts.
|
|
61
|
-
|
|
62
|
-
### Key Deltas
|
|
63
|
-
|
|
64
|
-
- Updated child-agent delegation guidance to reflect the Codex `spawn_agent` API:
|
|
65
|
-
- Use `spawn_agent(message: "<role prompt>\n\nTask: ...")` conventions.
|
|
66
|
-
- Removed legacy "instructions" phrasing.
|
|
67
|
-
- Expanded MCP tooling catalog and mode lifecycle expectations so orchestrators can use the full MCP surface correctly.
|
|
68
|
-
- `templates/AGENTS.md` header normalized to match `AGENTS.md` and removed the non-compliant template opener.
|
|
69
|
-
|
|
70
|
-
### Diff Stats
|
|
71
|
-
|
|
72
|
-
| File | Added | Removed | Notes |
|
|
73
|
-
|---|---:|---:|---|
|
|
74
|
-
| `AGENTS.md` | 42 | 10 | Tooling + delegation guidance expanded; semantics preserved. |
|
|
75
|
-
| `templates/AGENTS.md` | 7 | 7 | Header/tone normalized; still intended as a template copy. |
|
|
76
|
-
|
|
77
|
-
### Unified Guidance Schema Follow-Up (AGENTS + Runtime/Worker Alignment)
|
|
78
|
-
|
|
79
|
-
- Added canonical schema document: `docs/guidance-schema.md`.
|
|
80
|
-
- Added explicit schema-contract sections to:
|
|
81
|
-
- `AGENTS.md`
|
|
82
|
-
- `templates/AGENTS.md`
|
|
83
|
-
- Normalized worker task guidance in `AGENTS.md` runtime worker overlay:
|
|
84
|
-
- file path now uses `tasks/task-<id>.json`
|
|
85
|
-
- API id rule now explicitly requires bare id `task_id: "<id>"` (never `"task-<id>"`).
|
|
86
|
-
- Marker contracts remain unchanged:
|
|
87
|
-
- `<!-- RCS:RUNTIME:START --> ... <!-- RCS:RUNTIME:END -->`
|
|
88
|
-
- `<!-- RCS:TEAM:WORKER:START --> ... <!-- RCS:TEAM:WORKER:END -->`
|
|
89
|
-
|
|
90
|
-
Behavior note: this follow-up is additive and wording-focused; no task-state model or MCP API contract changes were introduced.
|
|
91
|
-
|
|
92
|
-
---
|
|
93
|
-
|
|
94
|
-
## Skill Prompt Migration (`skills/*/SKILL.md`)
|
|
95
|
-
|
|
96
|
-
### Summary
|
|
97
|
-
|
|
98
|
-
Skill docs are operational runbooks. The migration focused on:
|
|
99
|
-
- Removing Claude-era paths/terminology
|
|
100
|
-
- Aligning config guidance with Codex-first paths (`~/.codex/…`, `CODEX_HOME`)
|
|
101
|
-
- Preserving each skill's contract/intent while improving correctness for Codex CLI users
|
|
102
|
-
|
|
103
|
-
### Behavior Notes
|
|
104
|
-
|
|
105
|
-
- These are documentation / instruction changes; they do not directly change runtime logic.
|
|
106
|
-
- One meaningful correction was made: the "agent teams" enablement guidance in `skills/rcs-setup/SKILL.md` was updated to enable Codex features via `~/.codex/config.toml` rather than legacy `settings.json` env vars.
|
|
107
|
-
|
|
108
|
-
### Per-File Matrix
|
|
109
|
-
|
|
110
|
-
| Skill File | Added | Removed | Structural Highlights | Behavior Delta |
|
|
111
|
-
|---|---:|---:|---|---|
|
|
112
|
-
| `skills/analyze/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
113
|
-
| `skills/autopilot/SKILL.md` | 11 | 16 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
114
|
-
| `skills/code-review/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
115
|
-
| `skills/configure-notifications/SKILL.md` | 0 | 0 | Canonical notification setup skill replacing standalone configure-* variants. | Catalog/install surface now converges on one entry point. |
|
|
116
|
-
| `skills/doctor/SKILL.md` | 47 | 45 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
117
|
-
| `skills/ecomode/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
118
|
-
| `skills/help/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
119
|
-
| `skills/learner/SKILL.md` | 5 | 5 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
120
|
-
| `skills/rcs-setup/SKILL.md` | 144 | 156 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
121
|
-
| `skills/plan/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
122
|
-
| `skills/project-session-manager/SKILL.md` | 5 | 5 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
123
|
-
| `skills/release/SKILL.md` | 3 | 3 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
124
|
-
| `skills/research/SKILL.md` | 10 | 15 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
125
|
-
| `skills/security-review/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
126
|
-
| `skills/skill/SKILL.md` | 20 | 20 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
127
|
-
| `skills/tdd/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
128
|
-
| `skills/ultrapilot/SKILL.md` | 11 | 16 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
129
|
-
| `skills/writer-memory/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
|
|
130
|
-
|
|
131
|
-
### Hotspots Worth Reviewing
|
|
132
|
-
|
|
133
|
-
- `skills/rcs-setup/SKILL.md`: largest edit surface; includes team enablement guidance (`~/.codex/config.toml` `[features]` flags) and teammate display preference storage (`~/.codex/.rcs-config.json`).
|
|
134
|
-
- `skills/doctor/SKILL.md`: updated hook/config inspection language; still contains optional legacy remediation guidance.
|
|
135
|
-
- `skills/autopilot/SKILL.md`, `skills/research/SKILL.md`, `skills/ultrapilot/SKILL.md`: config examples updated to TOML.
|
|
136
|
-
|
|
137
|
-
## Follow-up Classification Notes
|
|
138
|
-
|
|
139
|
-
- `prompts/*.md` should be treated as the canonical source set for XML-tagged subagent role prompts, even when install/runtime layers wrap them in TOML or other launcher-specific envelopes.
|
|
140
|
-
- `prompts/sisyphus-lite.md` is intentionally classified as a specialized worker behavior prompt. It is not part of the primary public role catalog alongside prompts such as `executor`, `planner`, or `architect`.
|
|
141
|
-
- Team worker/runtime overlays may borrow Sisyphus-lite behavior patterns, but that does not promote it to a first-class routed role.
|
|
@@ -1,85 +0,0 @@
|
|
|
1
|
-
# QA Plan — v0.4.2 (dev vs deployed main)
|
|
2
|
-
|
|
3
|
-
Date: 2026-02-18
|
|
4
|
-
Scope: validate delta between `origin/main` (deployed, `v0.4.1`) and current `dev`.
|
|
5
|
-
|
|
6
|
-
## 1) Parity Validation Summary
|
|
7
|
-
|
|
8
|
-
Run:
|
|
9
|
-
|
|
10
|
-
```bash
|
|
11
|
-
git fetch origin --prune
|
|
12
|
-
git rev-list --left-right --count origin/main...dev
|
|
13
|
-
git log --oneline origin/main..dev
|
|
14
|
-
git diff --name-status origin/main...dev
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
Expected at time of writing:
|
|
18
|
-
- `origin/main` is deployed at `v0.4.1`.
|
|
19
|
-
- `dev` is ahead with feature/fix/test commits (auto-nudge improvements, all-workers-idle leader notification, tmux input/scrolling fixes, and coverage expansion).
|
|
20
|
-
- No non-merge functional commits were found on `main` that are missing from `dev`.
|
|
21
|
-
|
|
22
|
-
## 2) Risk-Based Focus Areas
|
|
23
|
-
|
|
24
|
-
1. **Notify hook behavior**
|
|
25
|
-
- Expanded stall phrase detection and new hot-zone detection logic.
|
|
26
|
-
- All-workers-idle leader notification with cooldown/event logging.
|
|
27
|
-
2. **Tmux team UX/reliability**
|
|
28
|
-
- Mouse scrolling enabled by default for team sessions.
|
|
29
|
-
- `sendToWorker` timing changes around submit rounds.
|
|
30
|
-
3. **Config compatibility**
|
|
31
|
-
- `collab` -> `multi_agent` migration in generated config + tests/docs.
|
|
32
|
-
4. **Lifecycle/process handling**
|
|
33
|
-
- `bin/rcs.js` now awaits `main(...)` and exits explicitly.
|
|
34
|
-
|
|
35
|
-
## 3) Automated QA
|
|
36
|
-
|
|
37
|
-
```bash
|
|
38
|
-
npm run test:run
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
Pass criteria:
|
|
42
|
-
- Full suite passes.
|
|
43
|
-
- New/updated suites specifically pass:
|
|
44
|
-
- `src/hooks/__tests__/notify-hook-all-workers-idle.test.ts`
|
|
45
|
-
- `src/hooks/__tests__/notify-hook-auto-nudge.test.ts`
|
|
46
|
-
- `src/team/__tests__/tmux-session.test.ts`
|
|
47
|
-
- `src/config/__tests__/generator-notify.test.ts`
|
|
48
|
-
- newly added extensibility/HUD/utils/verifier test files
|
|
49
|
-
|
|
50
|
-
## 4) Manual QA Checklist
|
|
51
|
-
|
|
52
|
-
### A. All workers idle notification
|
|
53
|
-
- Start a team session with >=2 workers.
|
|
54
|
-
- Let all workers transition to `idle` or `done`.
|
|
55
|
-
- Verify leader receives one idle-summary prompt.
|
|
56
|
-
- Re-trigger within cooldown window: verify no duplicate notification spam.
|
|
57
|
-
- Verify event/log entries are emitted.
|
|
58
|
-
|
|
59
|
-
### B. Auto-nudge pattern detection
|
|
60
|
-
- Feed outputs containing new phrases (e.g., "say go", "next I can", "keep driving").
|
|
61
|
-
- Verify stall detection triggers in the last-lines hot zone.
|
|
62
|
-
- Verify unrelated text does not false-trigger.
|
|
63
|
-
|
|
64
|
-
### C. Tmux input reliability + mouse scrolling
|
|
65
|
-
- In team mode, verify mouse wheel scrolls pane history.
|
|
66
|
-
- Confirm arrow keys still work for CLI input history.
|
|
67
|
-
- Send repeated worker prompts and verify submission consistency.
|
|
68
|
-
- Set `RCS_TEAM_MOUSE=0`, restart session, verify mouse mode is not forcibly enabled.
|
|
69
|
-
|
|
70
|
-
### D. Config generator migration
|
|
71
|
-
- Run setup/generator path on fresh and existing configs.
|
|
72
|
-
- Verify `[features]` includes `multi_agent = true` and `child_agents_md = true`.
|
|
73
|
-
- Verify deprecated `collab` key is not reintroduced.
|
|
74
|
-
|
|
75
|
-
### E. `/exit` process termination
|
|
76
|
-
- Launch `rcs` and invoke `/exit`.
|
|
77
|
-
- Verify process exits cleanly without hanging.
|
|
78
|
-
|
|
79
|
-
## 5) Release Gate
|
|
80
|
-
|
|
81
|
-
Release is approved only if:
|
|
82
|
-
- [ ] Automated tests pass.
|
|
83
|
-
- [ ] Manual checklist A–E passes.
|
|
84
|
-
- [ ] Changelog entry matches shipped behavior.
|
|
85
|
-
- [ ] Version is bumped consistently (`package.json`, `package-lock.json`).
|
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-
# QA Execution Report — v0.4.2
|
|
2
|
-
|
|
3
|
-
Date: 2026-02-18
|
|
4
|
-
|
|
5
|
-
## Team Execution
|
|
6
|
-
|
|
7
|
-
- Team run executed via `$team`.
|
|
8
|
-
- Initial stale workers were detected and cleaned (`%1749`, `%1750` panes removed).
|
|
9
|
-
- QA team completed with all tasks terminal (`completed=3, failed=0`) and was shut down cleanly.
|
|
10
|
-
|
|
11
|
-
## Parity Validation (deployed `main` vs `dev`)
|
|
12
|
-
|
|
13
|
-
Commands:
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
git rev-list --left-right --count origin/main...dev
|
|
17
|
-
git rev-list --left-right --count --no-merges origin/main...dev
|
|
18
|
-
git log --oneline --no-merges dev..origin/main
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
Result:
|
|
22
|
-
- Merge-aware divergence: `6 18`
|
|
23
|
-
- Non-merge divergence: `0 15`
|
|
24
|
-
- No non-merge commits on `main` missing from `dev`.
|
|
25
|
-
|
|
26
|
-
## Automated QA
|
|
27
|
-
|
|
28
|
-
Command executed:
|
|
29
|
-
|
|
30
|
-
```bash
|
|
31
|
-
npm test
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
Result:
|
|
35
|
-
- PASS — `664` tests passed, `0` failed.
|
|
36
|
-
|
|
37
|
-
Notes:
|
|
38
|
-
- `npm run test:run` is referenced in the QA plan but is not a script in current `package.json`.
|
|
39
|
-
|
|
40
|
-
## Release-Metadata Checks
|
|
41
|
-
|
|
42
|
-
- `package.json` version: `0.4.2`
|
|
43
|
-
- `package-lock.json` version: `0.4.2`
|
|
44
|
-
- `CHANGELOG.md` contains `## [0.4.2] - 2026-02-18`
|
|
45
|
-
|
|
46
|
-
## Manual QA Checklist (A–E)
|
|
47
|
-
|
|
48
|
-
- A/B/C/E require interactive runtime validation and were only partially validated through automated tests + code-path checks in this execution.
|
|
49
|
-
- D (config migration) covered by automated tests (`generator-notify` + config generator suite) and passed.
|
|
50
|
-
|
|
51
|
-
## Overall
|
|
52
|
-
|
|
53
|
-
- Automated quality gate: **PASS**
|
|
54
|
-
- Parity validation gate: **PASS**
|
|
55
|
-
- Manual interactive gate: **PARTIAL (requires explicit interactive pass if required before release)**
|
|
@@ -1,86 +0,0 @@
|
|
|
1
|
-
# RCS v0.9.0
|
|
2
|
-
|
|
3
|
-
<p align="center">
|
|
4
|
-
<img src="./shared/rcs-character-spark-initiative.jpg" alt="RCS character sparked for the Spark Initiative" width="720">
|
|
5
|
-
</p>
|
|
6
|
-
|
|
7
|
-
`0.9.0` is the Spark Initiative release: RCS now has a stronger native fast path for repository discovery, shell-native inspection, and cross-platform native distribution.
|
|
8
|
-
|
|
9
|
-
## Highlights
|
|
10
|
-
|
|
11
|
-
### `rcs explore`
|
|
12
|
-
|
|
13
|
-
- adds a dedicated read-only exploration entrypoint
|
|
14
|
-
- uses a Rust-backed explore harness
|
|
15
|
-
- keeps shell-native exploration constrained, allowlisted, and read-only
|
|
16
|
-
- supports packaged native resolution plus source/repo-local fallback paths
|
|
17
|
-
|
|
18
|
-
### `rcs sparkshell`
|
|
19
|
-
|
|
20
|
-
- adds an operator-facing native shell sidecar
|
|
21
|
-
- supports direct command execution
|
|
22
|
-
- summarizes long output into compact sections
|
|
23
|
-
- supports explicit tmux-pane summarization:
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
rcs sparkshell --tmux-pane %12 --tail-lines 400
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
### Explore ↔ sparkshell integration
|
|
30
|
-
|
|
31
|
-
- qualifying read-only shell-native `rcs explore` prompts can route through `rcs sparkshell`
|
|
32
|
-
- fallback behavior remains explicit and hardened
|
|
33
|
-
- guidance/docs/tests were aligned around this contract
|
|
34
|
-
|
|
35
|
-
### Worker follow-through polish
|
|
36
|
-
|
|
37
|
-
- worker mailbox guidance now asks for concrete progress updates without implying work should stop after replying
|
|
38
|
-
- inbox/mailbox trigger wording now tells workers to continue assigned or next feasible work after reporting status
|
|
39
|
-
- runtime/bootstrap wording and associated tests were aligned around this behavior
|
|
40
|
-
|
|
41
|
-
### Release pipeline upgrades
|
|
42
|
-
|
|
43
|
-
- cross-platform native publishing for:
|
|
44
|
-
- `rcs-explore-harness`
|
|
45
|
-
- `rcs-sparkshell`
|
|
46
|
-
- native release manifest generation with per-target metadata
|
|
47
|
-
- packed-install smoke verification in the release workflow
|
|
48
|
-
- `build:full` validated as the one-shot release-oriented build path
|
|
49
|
-
|
|
50
|
-
## Important Spark Initiative notes
|
|
51
|
-
|
|
52
|
-
- Users can install RCS normally with `npm install -g @jstn-sdk/rcs`.
|
|
53
|
-
- The npm tarball intentionally excludes staged cross-platform native binaries.
|
|
54
|
-
- Tagged releases publish verified native archives for `rcs-explore-harness` and `rcs-sparkshell`.
|
|
55
|
-
- Packaged installs hydrate the matching native binary through `native-release-manifest.json`.
|
|
56
|
-
- CI now hardens the Rust path with explicit toolchain setup, `cargo fmt --all --check`, and `cargo clippy --workspace --all-targets -- -D warnings`.
|
|
57
|
-
|
|
58
|
-
## Upgrade note
|
|
59
|
-
|
|
60
|
-
If you use project-scoped RCS installs, rerun:
|
|
61
|
-
|
|
62
|
-
```bash
|
|
63
|
-
rcs setup --force --scope project
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
after upgrading so managed config/native-agent paths are refreshed.
|
|
67
|
-
|
|
68
|
-
## Local release verification summary
|
|
69
|
-
|
|
70
|
-
Validated locally on `dev` before tagging:
|
|
71
|
-
|
|
72
|
-
- `node scripts/check-version-sync.mjs --tag v0.9.0`
|
|
73
|
-
- `npm run lint`
|
|
74
|
-
- `npx tsc --noEmit`
|
|
75
|
-
- `npm run check:no-unused`
|
|
76
|
-
- `npm test`
|
|
77
|
-
- `npm run build:full`
|
|
78
|
-
- `npm run test:explore`
|
|
79
|
-
- `npm run test:sparkshell`
|
|
80
|
-
- `node bin/rcs.js doctor`
|
|
81
|
-
- `node bin/rcs.js setup --dry-run`
|
|
82
|
-
- `npm pack --dry-run`
|
|
83
|
-
|
|
84
|
-
## Historical note
|
|
85
|
-
|
|
86
|
-
This archived release note is retained for product history, but current first-party release ownership lives on the current RCS repository and package coordinates.
|
|
@@ -1,41 +0,0 @@
|
|
|
1
|
-
# RCS v0.9.1
|
|
2
|
-
|
|
3
|
-
<p align="center">
|
|
4
|
-
<img src="./shared/rcs-character-spark-initiative.jpg" alt="RCS character sparked for the Spark Initiative" width="720">
|
|
5
|
-
</p>
|
|
6
|
-
|
|
7
|
-
`0.9.1` is a targeted Spark Initiative hotfix release.
|
|
8
|
-
|
|
9
|
-
## Why this release exists
|
|
10
|
-
|
|
11
|
-
- `v0.9.0` remains historically red.
|
|
12
|
-
- The required packed-install smoke hydration fix landed in the post-0.9.0 line and is reflected here as the superseding hotfix cut.
|
|
13
|
-
- `v0.9.1` is the clean superseding release cut from `main` with that fix applied.
|
|
14
|
-
|
|
15
|
-
## Included fix
|
|
16
|
-
|
|
17
|
-
### Localize smoke hydration assets
|
|
18
|
-
|
|
19
|
-
The packed-install smoke workflow now copies and resolves hydration assets from the local smoke workspace so release verification matches packaged-install behavior more reliably.
|
|
20
|
-
|
|
21
|
-
Changed files:
|
|
22
|
-
- `scripts/smoke-packed-install.mjs`
|
|
23
|
-
- `scripts/__tests__/smoke-packed-install.test.mjs`
|
|
24
|
-
|
|
25
|
-
## Local release verification summary
|
|
26
|
-
|
|
27
|
-
Planned local release-critical validation for `0.9.1`:
|
|
28
|
-
|
|
29
|
-
- `node scripts/check-version-sync.mjs --tag v0.9.1`
|
|
30
|
-
- `npm run lint`
|
|
31
|
-
- `npx tsc --noEmit`
|
|
32
|
-
- `npm run check:no-unused`
|
|
33
|
-
- `npm test`
|
|
34
|
-
- `node --test scripts/__tests__/smoke-packed-install.test.mjs`
|
|
35
|
-
- `npm run build:full`
|
|
36
|
-
- `npm run smoke:packed-install`
|
|
37
|
-
- `npm pack --dry-run`
|
|
38
|
-
|
|
39
|
-
## Historical note
|
|
40
|
-
|
|
41
|
-
`v0.9.0` remains historically red; `v0.9.1` is the clean superseding release.
|
|
Binary file
|
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
# Issue Draft: Make `blueprint` first-class for `team` follow-up planning
|
|
2
|
-
|
|
3
|
-
## Title
|
|
4
|
-
[Feature] Make `blueprint` emit explicit `team` follow-up guidance (for example `--followup team`)
|
|
5
|
-
|
|
6
|
-
## Problem
|
|
7
|
-
RCS already has the ingredients for a strong high-control workflow: `blueprint` for scoped planning and `team` for durable multi-worker execution with its own verification lanes. What is still under-explained and under-productized is the handoff between planning and team execution.
|
|
8
|
-
|
|
9
|
-
Today, experienced users can manually infer the pattern: run `blueprint`, then launch `team`, and let team own delivery plus verification unless a later single-owner follow-up is genuinely needed. The workflow's biggest advantage is not just parallelism. It is coordinated execution: teammates can surface blockers early, redistribute work, and stay inspectable through panes plus runtime state. That benefit should be reflected directly in planning output.
|
|
10
|
-
|
|
11
|
-
## Proposed solution
|
|
12
|
-
Teach `blueprint` to support an explicit team-oriented follow-up mode, such as `--followup team`, that produces:
|
|
13
|
-
|
|
14
|
-
1. a normal implementation plan and acceptance criteria
|
|
15
|
-
2. recommended worker lanes / role allocation
|
|
16
|
-
3. suggested reasoning levels by lane
|
|
17
|
-
4. explicit follow-up commands or launch hints for `rcs team` / `$team`
|
|
18
|
-
5. verification expectations that fit a standalone `team` execution path, plus optional later Forge follow-up guidance only when needed
|
|
19
|
-
|
|
20
|
-
This would make the intended workflow clearer:
|
|
21
|
-
|
|
22
|
-
```text
|
|
23
|
-
blueprint -> team
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## Why this is good
|
|
27
|
-
- Clarifies why `team` exists alongside `ultrawork`: team mode is about coordination and runtime control, not only fanout.
|
|
28
|
-
- Reduces the gap between planning output and actual coordination flow.
|
|
29
|
-
- Makes one of RCS's strongest workflows more discoverable for advanced users.
|
|
30
|
-
- Improves execution quality on runtime-edge-case and workflow-edge-case work, where durable coordination matters more than raw task splitting.
|
|
31
|
-
- Fits RCS's architecture well because the runtime already supports worker roles, mixed CLIs, runtime state, and inspectable team lifecycle commands.
|
|
32
|
-
|
|
33
|
-
## Alternatives considered
|
|
34
|
-
- Keep the pattern implicit in docs only. This helps discovery, but still leaves users to translate plans into worker lanes manually.
|
|
35
|
-
- Fold everything into `autopilot`. Useful for default automation, but weaker for users who want direct control over planning, staffing, and verification.
|
|
36
|
-
|
|
37
|
-
## Additional context
|
|
38
|
-
Expected user outcome: a user runs `blueprint`, sees a plan that is already shaped for team execution, launches `team` with less guesswork, and only escalates to `forge` later if a persistent single-owner follow-up is still needed after team execution.
|