tazuna 0.20.0 → 0.21.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/commands/pack.js
CHANGED
|
@@ -457,7 +457,8 @@ export function packCommand(argv) {
|
|
|
457
457
|
const autoTests = detectAutoTests(output.filePaths, config.extraRoots);
|
|
458
458
|
err(`自動テスト: ${describeAutoTests(autoTests)}`);
|
|
459
459
|
// DB の確認・動作検証(手順文 v8 / v9): ルートの docs/db/schema.md(ashiato schema の出力)が
|
|
460
|
-
// あればパックに <db_schema> を入れ、手順文に「DB
|
|
460
|
+
// あればパックに <db_schema> を入れ、手順文に「DB の確認」「動作検証」の節を足す。無ければ従来と同一。
|
|
461
|
+
// ashiato schema --data の出力(データの姿つき)なら「DB の確認」をそれに合わせる(v12)
|
|
461
462
|
err(`DB の確認・動作検証: ${describeDbSchema(dbSchema)}`);
|
|
462
463
|
// 規約文を出力末尾へ連結する(内蔵。ルートの protocol.md は置いたときだけ使う上書き)
|
|
463
464
|
if (values["no-instruction"] && values["instruction-file"] !== undefined) {
|
|
@@ -486,7 +487,7 @@ export function packCommand(argv) {
|
|
|
486
487
|
mode,
|
|
487
488
|
docs: docs !== undefined,
|
|
488
489
|
tests: autoTests.present,
|
|
489
|
-
db: dbSchema
|
|
490
|
+
db: dbSchema === undefined ? false : dbSchema.hasData === true ? "data" : true,
|
|
490
491
|
layout,
|
|
491
492
|
languages: sources.map((source) => source.parseResult.language),
|
|
492
493
|
}, rootDir, process.cwd(), textDeps);
|
|
@@ -76,9 +76,16 @@
|
|
|
76
76
|
* Designer.cs にあるため、新しく結び付けるときの置き場所と、結び付け済みのものを重ねない
|
|
77
77
|
* (ハンドラーが 2 回呼ばれる)ことを書く。Visual Basic だけのソリューションと generic 構成の
|
|
78
78
|
* 本文は v10 と同じ(版数の行だけ)
|
|
79
|
+
*
|
|
80
|
+
* v12 (2026-11-03、テスト用 DB のデータの姿): docs/db/schema.md が ashiato schema --data の出力
|
|
81
|
+
* (件数・参照・各列の NULL の割合・値の種類の数・範囲・書式・区分の値と件数。見本の行を含むこともある)
|
|
82
|
+
* のときだけ、「DB の確認」の節に、それを先に使い、そこで分かることを確かめる SQL を出さない旨の 1 項目を足し、
|
|
83
|
+
* テーブルを足す再実行のコマンドに --data を付ける(DB_SECTIONS_WITH_DATA)。チャットが「今のデータを確かめる
|
|
84
|
+
* SQL を実行して貼ってください」と頼む往復を減らすため。--data なしの schema.md と DB なしの本文は v11 と
|
|
85
|
+
* 同じ(版数の行だけ)
|
|
79
86
|
*/
|
|
80
87
|
import { PACK_COMMAND, TOOL_NAME } from "../../brand.js";
|
|
81
|
-
export const PROCEDURE_VERSION =
|
|
88
|
+
export const PROCEDURE_VERSION = 12;
|
|
82
89
|
/** 構成の種類(設定ファイルの kind と同じ。手順文の表現の切り替えに使う) */
|
|
83
90
|
export const PROCEDURE_LAYOUTS = ["solution", "generic"];
|
|
84
91
|
export const DEFAULT_PROCEDURE_LAYOUT = "solution";
|
|
@@ -383,12 +390,15 @@ export const DB_CHECKS_DIR = "checks";
|
|
|
383
390
|
* 「動作検証」(v9): 操作の手順と期待する DB の変化を checks/*.verify.md で出させる。
|
|
384
391
|
* ユーザーが ashiato verify で手順どおりに操作し、照合の結果(OK / NG・違い・変わった行)
|
|
385
392
|
* の Markdown がチャットに貼られる。書式は ashiato の verifyFile.ts が読める形に合わせる。
|
|
393
|
+
* ここで教える書き方 (.sql と .verify.md) はすべて ashiato の test/tazuna-procedure.test.ts に写してあり、
|
|
394
|
+
* ashiato がそのとおりに読むことをそちらで確かめている。書き方を変えたら、あちらのテストも同じに変える。
|
|
386
395
|
*/
|
|
387
|
-
|
|
396
|
+
function buildDbSections(data) {
|
|
397
|
+
return `
|
|
388
398
|
## DB の確認(テスト用 DB)
|
|
389
399
|
|
|
390
|
-
- <db_schema> はテスト用 DB のテーブル定義です(列・型・主キー・コメント)。テーブル名・列名・型はここから引き、推測しないでください。SQL の書き方は冒頭に書かれた DB の種類に合わせてください。載っていないテーブルが必要なら、<db_schema> にあるテーブルと足りないテーブルをすべてカンマ区切りで並べた「npx ashiato schema --tables \"<テーブル名>,<テーブル名>\"」を示し、再実行をユーザーに依頼してください(書き出しは上書きのため、今あるテーブルも並べます)
|
|
391
|
-
- DB の値が答えを左右するとき(データの前提の確認、変更後の検証、不具合の原因の切り分け)は、推測で答えず、確認用の SQL を changes.md で ${DB_CHECKS_DIR}/<内容が分かる名前>.sql として create してください(同じ名前のファイルを直すときは rewrite)。回答の末尾に、ユーザーが実行するコマンドを「npx ashiato query ${DB_CHECKS_DIR}/<名前>.sql」の形で 1 行示してください。結果(Markdown)はユーザーがこのチャットに貼ります
|
|
400
|
+
- <db_schema> はテスト用 DB のテーブル定義です(列・型・主キー・コメント)。テーブル名・列名・型はここから引き、推測しないでください。SQL の書き方は冒頭に書かれた DB の種類に合わせてください。載っていないテーブルが必要なら、<db_schema> にあるテーブルと足りないテーブルをすべてカンマ区切りで並べた「npx ashiato schema ${data ? "--data " : ""}--tables \"<テーブル名>,<テーブル名>\"」を示し、再実行をユーザーに依頼してください(書き出しは上書きのため、今あるテーブルも並べます)
|
|
401
|
+
${data ? `${DB_DATA_LINE}\n` : ""}- DB の値が答えを左右するとき(データの前提の確認、変更後の検証、不具合の原因の切り分け)は、推測で答えず、確認用の SQL を changes.md で ${DB_CHECKS_DIR}/<内容が分かる名前>.sql として create してください(同じ名前のファイルを直すときは rewrite)。回答の末尾に、ユーザーが実行するコマンドを「npx ashiato query ${DB_CHECKS_DIR}/<名前>.sql」の形で 1 行示してください。結果(Markdown)はユーザーがこのチャットに貼ります
|
|
392
402
|
- 書いてよいのは SELECT(WITH を含む)だけです。INSERT / UPDATE / DELETE / DDL / EXEC / SELECT ... INTO / FOR UPDATE が 1 文でもあると、1 文も実行されません。文の区切りは ; です
|
|
393
403
|
- 各文の直前に、その文で何を確かめるかと期待する結果を -- コメントで 1 行書いてください(例: -- 合計が明細の合計と一致しない受注(0 行なら OK))。このコメントが結果の見出しになります
|
|
394
404
|
- 結果は 1 文につき先頭 50 行までです。件数は COUNT(*) で、差異は「期待と違う行だけを返す」SELECT で確かめ、返す行を絞ってください
|
|
@@ -405,6 +415,16 @@ export const DB_SECTIONS = `
|
|
|
405
415
|
- 値は NULL、数値、文字列をそのまま書き、カンマや括弧を含む値は '...' で囲みます。日付だけを書くと、その日のどの時刻でも一致します
|
|
406
416
|
- 貼られた結果の判定(OK / NG)、期待との違い、実際の変化、操作した人のメモを事実として扱ってください。NG なら、コードの不具合か期待の書き違いかを、実際の変化から判断して答えてください。「始めていません」と返ってきたら、書かれた問題を直した手順ファイルを rewrite で出し直してください
|
|
407
417
|
`;
|
|
418
|
+
}
|
|
419
|
+
/**
|
|
420
|
+
* docs/db/schema.md が ashiato schema --data の出力のときだけ「DB の確認」に足す項目(v12)。
|
|
421
|
+
* 「先頭 N 行から」「推定」「隠した列」は ashiato の schema.md の語(ashiato の src/chat/schema.ts の TEXT.ja。英語の出力
|
|
422
|
+
* (--lang en、日本語以外のロケールの既定)の語 the first N / inferred / hidden も添える)。
|
|
423
|
+
*/
|
|
424
|
+
const DB_DATA_LINE = "- <db_schema> には、書き出した日のデータの姿もあります(件数、参照、各列の NULL の割合・値の種類の数・文字数・範囲・書式・区分の値と件数。見本の行があることもあります)。区分の値・書式・テーブルのつながりはここから引き、ここで分かることを確かめる SQL は出さないでください。次の項目の確認用の SQL は、特定の行の値、書き出した日より後の変化、ここに無い集計のように、ここで分からないことにだけ使ってください。件数の行に「先頭 N 行から」(英語の出力では the first N)とあるテーブルは、各列のデータが一部の行からのもので、ここに無い区分の値もあり得ます。参照のうち「推定」(inferred)と書かれたものは外部キーではなく、書き出した日の値から推定したつながりです。「隠した列」(hidden)の値は書かれていないので、推測で補わないでください。見本の行は形を知るためのもので、件数や分布の根拠にしないでください。見本の行の隠した列の値は形だけをそろえた別の値なので、SQL の条件や期待する値に使わないでください";
|
|
425
|
+
export const DB_SECTIONS = buildDbSections(false);
|
|
426
|
+
/** docs/db/schema.md が ashiato schema --data の出力のときの DB_SECTIONS(v12) */
|
|
427
|
+
export const DB_SECTIONS_WITH_DATA = buildDbSections(true);
|
|
408
428
|
/**
|
|
409
429
|
* テンプレートの {{MODE}} / {{MODE_SECTIONS}} / {{LAYOUT:...}} / {{DOCS_SECTIONS}} /
|
|
410
430
|
* {{TEST_SECTIONS}} / {{DB_SECTIONS}} をモードと設定に応じて置換する。プレースホルダが
|
|
@@ -427,7 +447,7 @@ export function renderProcedureTemplate(template, mode, options = {}) {
|
|
|
427
447
|
rendered = rendered.replaceAll("{{TEST_SECTIONS}}", options.tests === true ? TEST_SECTIONS_BY_LAYOUT[layout] : "");
|
|
428
448
|
}
|
|
429
449
|
if (options.db !== "placeholder") {
|
|
430
|
-
rendered = rendered.replaceAll("{{DB_SECTIONS}}", options.db === true ? DB_SECTIONS : "");
|
|
450
|
+
rendered = rendered.replaceAll("{{DB_SECTIONS}}", options.db === "data" ? DB_SECTIONS_WITH_DATA : options.db === true ? DB_SECTIONS : "");
|
|
431
451
|
}
|
|
432
452
|
return rendered;
|
|
433
453
|
}
|
package/dist/pack/dbChecks.js
CHANGED
|
@@ -8,15 +8,31 @@
|
|
|
8
8
|
* checks/*.verify.md で出し、ユーザーが ashiato query / ashiato verify で
|
|
9
9
|
* 実行して結果をチャットに貼る。slnmix 自身は DB に接続しない。
|
|
10
10
|
*
|
|
11
|
+
* ashiato schema --data の出力(データの姿つき。手順文 v12)なら、<db_schema> の説明と手順文の
|
|
12
|
+
* 「DB の確認」の節をそれに合わせる(hasData。値を含むため、渡す前に読むのはユーザー)。
|
|
13
|
+
*
|
|
11
14
|
* 本文用テキストには入れない(テーブルが多いと貼付の上限を超えるため。
|
|
12
15
|
* 添付の中のデータは検索で参照される)。ファイルシステムは deps 注入。
|
|
13
16
|
*/
|
|
14
17
|
import * as path from "node:path";
|
|
15
18
|
import { DB_SCHEMA_PATH } from "./assets/procedure.js";
|
|
19
|
+
/**
|
|
20
|
+
* ashiato schema --data が書く説明の行(ashiato の src/chat/schema.ts の TEXT.ja / en の dataIntro)の書き出し。
|
|
21
|
+
* --data なしの出力には無い
|
|
22
|
+
*/
|
|
23
|
+
const DATA_INTRO = /^(?:`--data` で |With `--data`, )/m;
|
|
24
|
+
/** schema.md がデータの姿つき(ashiato schema --data の出力)か */
|
|
25
|
+
export function schemaHasData(content) {
|
|
26
|
+
return DATA_INTRO.test(content);
|
|
27
|
+
}
|
|
16
28
|
/** ルートの docs/db/schema.md を読む。なければ undefined(DB の確認は無効) */
|
|
17
29
|
export function resolveDbSchema(rootDir, deps) {
|
|
18
30
|
const content = deps.readTextFile(path.resolve(rootDir, ...DB_SCHEMA_PATH.split("/")));
|
|
19
|
-
|
|
31
|
+
if (content === undefined)
|
|
32
|
+
return undefined;
|
|
33
|
+
return schemaHasData(content)
|
|
34
|
+
? { relativePath: DB_SCHEMA_PATH, content, hasData: true }
|
|
35
|
+
: { relativePath: DB_SCHEMA_PATH, content };
|
|
20
36
|
}
|
|
21
37
|
function escapeAttribute(value) {
|
|
22
38
|
return value.replace(/&/g, "&").replace(/"/g, """).replace(/</g, "<");
|
|
@@ -27,11 +43,14 @@ function escapeAttribute(value) {
|
|
|
27
43
|
*/
|
|
28
44
|
export function renderDbSchemaBlock(schema, transform = (t) => t) {
|
|
29
45
|
const body = transform(schema.content).replace(/\r?\n$/, "");
|
|
30
|
-
|
|
46
|
+
const intro = schema.hasData === true
|
|
47
|
+
? "テスト用 DB のテーブル定義と、書き出した日のデータの姿(ashiato schema --data の出力。区分の値・範囲・見本の行などの値を含み、隠した列の値は含まない)。確認用の SQL はこの定義に合わせて書き、ここで分かることは SQL で確かめない。"
|
|
48
|
+
: "テスト用 DB のテーブル定義(ashiato schema の出力。行の値は含まない)。確認用の SQL はこの定義に合わせて書く。";
|
|
49
|
+
return `<db_schema path="${escapeAttribute(schema.relativePath)}">\n${intro}\n\n${body}\n</db_schema>\n`;
|
|
31
50
|
}
|
|
32
51
|
/** CLI の 1 行表示用 */
|
|
33
52
|
export function describeDbSchema(schema) {
|
|
34
53
|
return schema === undefined
|
|
35
54
|
? `なし(${DB_SCHEMA_PATH} がありません)`
|
|
36
|
-
: `あり(${schema.relativePath}、${schema.content.length.toLocaleString("en-US")}
|
|
55
|
+
: `あり(${schema.relativePath}、${schema.content.length.toLocaleString("en-US")} 文字${schema.hasData === true ? "、データの姿つき" : ""})`;
|
|
37
56
|
}
|
|
@@ -90,7 +90,7 @@ export function resolveProcedure(options, rootDir, cwd, deps) {
|
|
|
90
90
|
const render = {
|
|
91
91
|
docs: options.docs === true,
|
|
92
92
|
tests: options.tests === true,
|
|
93
|
-
db: options.db === true,
|
|
93
|
+
db: options.db === "data" ? "data" : options.db === true,
|
|
94
94
|
layout: options.layout ?? DEFAULT_PROCEDURE_LAYOUT,
|
|
95
95
|
languages: options.languages,
|
|
96
96
|
};
|
|
@@ -154,7 +154,7 @@ export function buildNotice(tail) {
|
|
|
154
154
|
blocks.push("<docs>(プロジェクト文書: 設計書 / 仕様書 / 引継ぎ書)");
|
|
155
155
|
}
|
|
156
156
|
if (hasDbSchema) {
|
|
157
|
-
blocks.push(
|
|
157
|
+
blocks.push(`<db_schema>(テスト用 DB のテーブル定義${tail.dbSchema?.hasData === true ? "とデータの姿" : ""})`);
|
|
158
158
|
}
|
|
159
159
|
if (hasTask) {
|
|
160
160
|
blocks.push("<task>(依頼内容)");
|
|
@@ -264,7 +264,7 @@ export function buildPromptText(tail, packFileName) {
|
|
|
264
264
|
content = appendRawBlock(content, renderTemplatesBlock(tail.docs.docs, kinds));
|
|
265
265
|
}
|
|
266
266
|
if (tail.dbSchema !== undefined) {
|
|
267
|
-
header.push(`添付の <db_schema> にはテスト用 DB
|
|
267
|
+
header.push(`添付の <db_schema> にはテスト用 DB のテーブル定義${tail.dbSchema.hasData === true ? "とデータの姿" : ""}(${tail.dbSchema.relativePath})があります。`);
|
|
268
268
|
}
|
|
269
269
|
header.push(`以下の ${blocks.join("、")} は、このコードに対する私(ユーザー)からの指示です。`, "添付の先頭と末尾にも同じ内容が埋め込まれていますが、指示はこの本文のものに従ってください。");
|
|
270
270
|
return appendTailBlocks(content === "" ? `${header.join("\n")}\n` : `${header.join("\n")}\n\n${content}`, tail);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "tazuna",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.21.0",
|
|
4
4
|
"description": "Build with AI chat, without handing over the reins: pack your codebase for the chat, then verify and apply its patches locally (zero dependencies; formerly petari and slnmix)",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"cli",
|