@jskit-ai/jskit-cli 0.2.89 → 0.2.91
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/package.json +4 -4
- package/src/server/commandHandlers/session.js +173 -142
- package/src/server/core/argParser.js +0 -4
- package/src/server/core/commandCatalog.js +47 -35
- package/src/server/sessionRuntime/constants.js +125 -348
- package/src/server/sessionRuntime/io.js +2 -2
- package/src/server/sessionRuntime/preconditions.js +39 -143
- package/src/server/sessionRuntime/promptRenderer.js +2 -15
- package/src/server/sessionRuntime/prompts/app_blueprint.md +2 -7
- package/src/server/sessionRuntime/prompts/{automated_checks.md → automated_checks_run.md} +2 -17
- package/src/server/sessionRuntime/prompts/{update_blueprint.md → blueprint_updated.md} +2 -11
- package/src/server/sessionRuntime/prompts/{deep_ui_check.md → deep_ui_check_run.md} +2 -19
- package/src/server/sessionRuntime/prompts/final_report_created.md +44 -0
- package/src/server/sessionRuntime/prompts/issue_created.md +26 -0
- package/src/server/sessionRuntime/prompts/issue_prompt_rendered.md +1 -0
- package/src/server/sessionRuntime/prompts/{plan_issue.md → make_plan.md} +8 -37
- package/src/server/sessionRuntime/prompts/{execute_plan.md → plan_executed.md} +4 -29
- package/src/server/sessionRuntime/prompts/{prepare_pr_merge.md → pr_merge_prepared.md} +3 -3
- package/src/server/sessionRuntime/prompts/{resolve_deslop_findings.md → review_changes_accepted_resolve.md} +2 -6
- package/src/server/sessionRuntime/prompts/{review_changes.md → review_prompt_rendered.md} +3 -28
- package/src/server/sessionRuntime/prompts/{user_check.md → user_check_completed.md} +1 -11
- package/src/server/sessionRuntime/responses.js +431 -292
- package/src/server/sessionRuntime.js +1201 -926
- package/src/server/sessionRuntime/prompts/issue_details.md +0 -49
- package/src/server/sessionRuntime/prompts/new_issue.md +0 -46
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
Gather exact issue details for JSKIT session {{session_id}}.
|
|
2
|
-
|
|
3
|
-
GitHub issue: {{issue_url}}
|
|
4
|
-
Issue number: {{issue_number}}
|
|
5
|
-
Issue title: {{issue_title}}
|
|
6
|
-
Issue body file: {{issue_file}}
|
|
7
|
-
Issue details file JSKIT will write after user approval (`issue_details.md`): {{issue_details_file}}
|
|
8
|
-
Worktree: {{worktree}}
|
|
9
|
-
|
|
10
|
-
This step exists before planning. Do not edit files, create session receipts, create or overwrite the issue details file, create commits, create branches, create issues, create pull requests, merge, or clean worktrees. JSKIT will save the approved details to the issue details file after the user reviews them.
|
|
11
|
-
|
|
12
|
-
No stones unturned:
|
|
13
|
-
|
|
14
|
-
- Read the issue and inspect the app enough to understand the implementation surface.
|
|
15
|
-
- Read `.jskit/APP_BLUEPRINT.md` and `.jskit/helper-map.md` when present.
|
|
16
|
-
- Read package.json, `.jskit/lock.json`, `config/public.js`, relevant `src/`, relevant `packages/`, and relevant package docs or `npx --no-install jskit show ... --details`.
|
|
17
|
-
- Read JSKIT agent docs before inferring framework patterns from source. Start with `node_modules/@jskit-ai/agent-docs/DISTR_AGENT.md`, `node_modules/@jskit-ai/agent-docs/guide/agent/index.md`, and `node_modules/@jskit-ai/agent-docs/patterns/INDEX.md` when present. If working inside the JSKIT monorepo or a devlinked sibling, use `packages/agent-docs/...` as the source-tree equivalent. Then read the specific pattern docs that match the issue: CRUD, page scaffolding, surfaces, placements, client requests, live actions, generated UI contracts, or UI testing.
|
|
18
|
-
- Ask follow-up questions until all important issue details are known.
|
|
19
|
-
- Ask the user for whatever is still needed.
|
|
20
|
-
- Ask for final confirmation before emitting final details.
|
|
21
|
-
- Do not output the final markers below until the user has confirmed the details.
|
|
22
|
-
|
|
23
|
-
For CRUD or persisted data, confirm entity/table name, fields, field types, nullability, defaults, uniqueness, indexes, relationships, ownership, allowed operations, list/view/form shape, validation, permissions, migration/generator lane, and exact CRUD generator command or exact reason no CRUD generator applies.
|
|
24
|
-
|
|
25
|
-
For UI, confirm route path, surface/placement target, navigation expectations, responsive layout, loading/empty/error/disabled/success states, Material/Vuetify expectations, Playwright verification path, and auth/bootstrap strategy if needed.
|
|
26
|
-
|
|
27
|
-
For server-only work, confirm endpoint/command/job shape, request/response shape, validation, auth/permission behavior, persistence ownership, error behavior, and verification path.
|
|
28
|
-
|
|
29
|
-
For package/generator work, confirm exact `npx --no-install jskit add` or `npx --no-install jskit generate` command, why it applies, expected generated files, and follow-up custom code areas.
|
|
30
|
-
|
|
31
|
-
When source files and docs appear to disagree, ask or record the discrepancy. Do not silently prefer code archaeology over package-owned JSKIT guide and pattern docs.
|
|
32
|
-
|
|
33
|
-
When the details are confirmed, output only the final classification, details, and decision notes surrounded by these exact markers:
|
|
34
|
-
|
|
35
|
-
[issue_category]
|
|
36
|
-
<client | server | client_server | tooling | unknown>
|
|
37
|
-
[/issue_category]
|
|
38
|
-
|
|
39
|
-
[ui_impact]
|
|
40
|
-
<none | possible | definite | unknown>
|
|
41
|
-
[/ui_impact]
|
|
42
|
-
|
|
43
|
-
[issue_details]
|
|
44
|
-
<confirmed issue details in Markdown>
|
|
45
|
-
[/issue_details]
|
|
46
|
-
|
|
47
|
-
[agent_decisions]
|
|
48
|
-
<concise decision entries with reasons>
|
|
49
|
-
[/agent_decisions]
|
|
@@ -1,46 +0,0 @@
|
|
|
1
|
-
Create a GitHub issue from this user request:
|
|
2
|
-
|
|
3
|
-
{{user_input}}
|
|
4
|
-
|
|
5
|
-
First inspect the local app enough to understand the request in context. App setup has already passed before this prompt is rendered; treat this as a ready JSKIT app. This issue-drafting step is read-only.
|
|
6
|
-
|
|
7
|
-
Allowed inspection:
|
|
8
|
-
|
|
9
|
-
- Read files with commands such as `pwd`, `ls`, `find`, `rg`, `cat`, `sed`, and `git status`.
|
|
10
|
-
- Read package.json, `.jskit/lock.json`, config, routes, packages, source files, `.jskit/APP_BLUEPRINT.md`, and `.jskit/helper-map.md` when available.
|
|
11
|
-
- Use non-mutating JSKIT inspection commands when available and relevant: `npx --no-install jskit list`, `npx --no-install jskit show <package> --details`, and `npx --no-install jskit list-placements`.
|
|
12
|
-
- Read JSKIT agent docs before inferring framework patterns from source. Start with `node_modules/@jskit-ai/agent-docs/DISTR_AGENT.md`, `node_modules/@jskit-ai/agent-docs/guide/agent/index.md`, and `node_modules/@jskit-ai/agent-docs/patterns/INDEX.md` when present. If working inside the JSKIT monorepo or a devlinked sibling, use `packages/agent-docs/...` as the source-tree equivalent. Then read only the relevant pattern docs for the request, such as CRUD, page scaffolding, surfaces, placements, client requests, live actions, or UI testing.
|
|
13
|
-
- If the filesystem contradicts a ready JSKIT app, stop and report that app setup must be rerun. Do not draft a recovery issue inside this session.
|
|
14
|
-
|
|
15
|
-
Do not run workflow, repair, or mutation commands during issue drafting:
|
|
16
|
-
|
|
17
|
-
- Do not run `npx --no-install jskit session`, `npx --no-install jskit session step`, or any command that advances a JSKIT session.
|
|
18
|
-
- Do not run `gh`, `git add`, `git commit`, `git push`, `npm install`, generators, tests, verification, devlinks, or doctor commands.
|
|
19
|
-
- Do not try to fix missing PATH entries or missing helper binaries. If a tool is unavailable, continue with read-only file inspection.
|
|
20
|
-
- Do not edit files.
|
|
21
|
-
|
|
22
|
-
Draft an implementation-ready issue, not a broad product essay.
|
|
23
|
-
|
|
24
|
-
Preserve these JSKIT boundaries:
|
|
25
|
-
|
|
26
|
-
- If platform choices are still provisional, make the issue resolve those choices before installing tenancy-sensitive packages.
|
|
27
|
-
- Do not ask the developer to redesign standard JSKIT package-owned workflows from scratch. Treat selected package workflows as defaults unless the request asks for overrides, restrictions, or custom additions.
|
|
28
|
-
- For persisted app-owned data, prefer generated/package ownership over direct hand-built persistence. A new ordinary table should usually become a server CRUD-owned entity before CRUD UI or route work.
|
|
29
|
-
- For non-CRUD app pages, prefer the JSKIT UI generator when it fits.
|
|
30
|
-
- Keep direct knex or low-level runtime work exceptional and explicitly justified.
|
|
31
|
-
- Prefer documented JSKIT guide and pattern docs over reverse-engineering framework architecture from source files. Use source inspection to understand this app and verify details, not as the first source of JSKIT design rules.
|
|
32
|
-
- Do not include workflow bookkeeping such as old workboards in the issue body. JSKIT session state and receipts are the workflow tracker.
|
|
33
|
-
|
|
34
|
-
Ask concise clarifying questions if the request is not specific enough to produce a useful implementation issue. Ask only for details that materially change the ticket.
|
|
35
|
-
|
|
36
|
-
When the issue is ready, output only the final issue title and body surrounded by these exact markers:
|
|
37
|
-
|
|
38
|
-
[issue_title]
|
|
39
|
-
<short issue title>
|
|
40
|
-
[/issue_title]
|
|
41
|
-
|
|
42
|
-
[issue_text]
|
|
43
|
-
<issue body in Markdown, without repeating the title as a heading>
|
|
44
|
-
[/issue_text]
|
|
45
|
-
|
|
46
|
-
The issue should be concrete, scoped, and implementation-ready. Include acceptance criteria when they are useful.
|