@infodb/p3 0.12.0 â 0.13.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/README.md +32 -35
- package/dist/web/assets/CompletionReview-gZKZrDu_.js +1 -0
- package/dist/web/assets/ImprovementDialog-Dno6dPnG.js +1 -0
- package/dist/web/assets/Outputs-BgHalMGb.js +1 -0
- package/dist/web/assets/RequestStatus-hZcBUUIu.js +1 -0
- package/dist/web/assets/Tabs-C3NmwCc3.js +1 -0
- package/dist/web/assets/TagInput-B2b862qn.js +1 -0
- package/dist/web/assets/TaskDrawer-4BQBELXa.js +6 -0
- package/dist/web/assets/_requestId-BMAG1t3o.js +1 -0
- package/dist/web/assets/_requestId-tbg2pA2S.js +1 -0
- package/dist/web/assets/archive-DMl6WyOe.js +1 -0
- package/dist/web/assets/board-BMTcHKyt.js +1 -0
- package/dist/web/assets/done-CL6Nlsua.js +1 -0
- package/dist/web/assets/draft-BvGxfD7v.js +2 -0
- package/dist/web/assets/index-Dp7Fc4VI.css +2 -0
- package/dist/web/assets/index-KdlgMitg.js +12 -0
- package/dist/web/assets/metrics-Cu7gJ7Rk.js +1 -0
- package/dist/web/assets/new-DTXWHuFO.js +1 -0
- package/dist/web/assets/outputs-CXqnjSqV.js +1 -0
- package/dist/web/assets/preflightInput-ClKwkp8R.js +2 -0
- package/dist/web/assets/preload-helper-oLCrNCwz.js +1 -0
- package/dist/web/assets/{quality-Pu6EISAM.js â quality-RFd-7k3r.js} +1 -1
- package/dist/web/assets/release-notes-Bpdi6RdY.js +5 -0
- package/dist/web/assets/requestData-CbFxwW5w.js +1 -0
- package/dist/web/assets/routes-BIt8bExF.js +6 -0
- package/dist/web/assets/settings-CsCqF_1B.js +1 -0
- package/dist/web/assets/ui-BGK72r3u.js +1 -0
- package/dist/web/assets/workTarget-CySfKyfB.js +30 -0
- package/dist/web/index.html +4 -4
- package/docs/architecture.md +300 -36
- package/docs/development.md +60 -16
- package/docs/how-to-use.md +381 -28
- package/docs/installation.md +235 -144
- package/docs/publishing.md +1 -1
- package/lib/cli/agentsStatus.js +197 -0
- package/lib/cli/args.js +72 -8
- package/lib/cli/guide.js +27 -0
- package/lib/cli/guide.md +214 -0
- package/lib/cli/help.js +44 -6
- package/lib/cli/main.js +76 -20
- package/lib/cli/metricsCommands.js +77 -0
- package/lib/cli/output.js +12 -2
- package/lib/cli/project.js +13 -27
- package/lib/cli/qualityCommands.js +33 -8
- package/lib/cli/readOnly.js +15 -0
- package/lib/cli/requestCommands.js +21 -4
- package/lib/cli/requirementCommands.js +288 -0
- package/lib/cli/retroCommands.js +106 -0
- package/lib/cli/revisitCommands.js +73 -0
- package/lib/cli/showView.js +119 -6
- package/lib/cli/taskCommands.js +42 -16
- package/lib/cli/userConfig.js +47 -0
- package/lib/core/completionRefs.js +46 -0
- package/lib/core/metrics/definitions.js +434 -0
- package/lib/core/metrics/index.js +88 -0
- package/lib/core/metrics/manual.js +180 -0
- package/lib/core/ops.js +15 -2
- package/lib/core/preflight/carryover.js +5 -1
- package/lib/core/preflight/codexEngine.js +34 -17
- package/lib/core/preflight/diagnose.js +4 -9
- package/lib/core/preflight/engine.js +9 -0
- package/lib/core/preflight/hostPaths.js +260 -0
- package/lib/core/preflight/input.js +33 -5
- package/lib/core/preflight/instructions.js +18 -1
- package/lib/core/preflight/mockEngine.js +20 -2
- package/lib/core/preflight/render.js +22 -3
- package/lib/core/preflight/service.js +59 -9
- package/lib/core/preflight/uiRender.js +3 -0
- package/lib/core/requestOps.js +206 -14
- package/lib/core/retrospective.js +208 -0
- package/lib/core/reviewCandidates.js +56 -0
- package/lib/core/store/collection.js +20 -1
- package/lib/core/store/normalize.js +22 -4
- package/lib/core/store/preflightStore.js +19 -5
- package/lib/core/store/workspace.js +17 -1
- package/lib/core/taskReview/material.js +7 -0
- package/lib/core/taskReview/review.js +9 -2
- package/lib/server/api/manifest.js +51 -3
- package/lib/server/api/routes.js +131 -11
- package/lib/shared/acceptance.js +258 -18
- package/lib/shared/completionRecord.js +327 -0
- package/lib/shared/metrics.js +42 -0
- package/lib/shared/preflightInput.js +1 -1
- package/lib/shared/requirementSource.js +635 -0
- package/lib/shared/retrospective.js +286 -0
- package/lib/shared/reviewCandidate.js +308 -0
- package/lib/shared/reworkHistory.js +81 -0
- package/package.json +3 -2
- package/skills/p3/SKILL.md +9 -181
- package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +0 -1
- package/dist/web/assets/Outputs-_nU_p3nu.js +0 -1
- package/dist/web/assets/RequestStatus-RG-OVQYY.js +0 -1
- package/dist/web/assets/Tabs-ew9i5SKX.js +0 -1
- package/dist/web/assets/TagInput-BtlJTF7i.js +0 -1
- package/dist/web/assets/TaskDrawer-DW8GyJqI.js +0 -6
- package/dist/web/assets/_requestId-6Nb727dD.js +0 -1
- package/dist/web/assets/_requestId-BykTgPax.js +0 -1
- package/dist/web/assets/appCtx-CxDdXABS.js +0 -1
- package/dist/web/assets/archive-Ckh295Xe.js +0 -1
- package/dist/web/assets/board-BVAIjK-Y.js +0 -1
- package/dist/web/assets/done-BGfA-3MA.js +0 -1
- package/dist/web/assets/draft-CfJeyLOl.js +0 -1
- package/dist/web/assets/index-CgRU744I.css +0 -2
- package/dist/web/assets/index-DacQ0yl4.js +0 -12
- package/dist/web/assets/new-DVygWvVc.js +0 -1
- package/dist/web/assets/outputs-B6xDsLZf.js +0 -1
- package/dist/web/assets/preflightInput-BAeEJYUK.js +0 -2
- package/dist/web/assets/preload-helper-DyCqp21K.js +0 -1
- package/dist/web/assets/release-notes-CCpzyiNf.js +0 -5
- package/dist/web/assets/requestData-D5vBnuMh.js +0 -1
- package/dist/web/assets/routes-Q91zvNc0.js +0 -4
- package/dist/web/assets/settings-BzRgcmUm.js +0 -1
- package/dist/web/assets/workTarget-C9c57JAO.js +0 -30
package/docs/architecture.md
CHANGED
|
@@ -518,6 +518,48 @@ include: true
|
|
|
518
518
|
空ã®ç°å¢å€æ°ã¯æ¢å®ã«æ»ãã®ã§åºã©ãããæ¢å®ããããžã§ã¯ãã®ç»é²ïŒprojectsïŒã¯è¡šç€ºããªãïŒ`p3 project ls`ïŒ
|
|
519
519
|
- ãã¹ã®å¯Ÿå¿ã®ãšã©ãŒïŒ`bind source path does not exist`ïŒã«ã¯ãçŽãæ¹ïŒ`pathMapHowTo`ïŒãšããŠèšå®ããã³ãã³ãã»äŸã»ãã¹ãã®
|
|
520
520
|
ãã¹ã®èª¿ã¹æ¹ãæ·»ãããå
±æã®èšé²ã«æ®ãã®ã§ããã®ãã·ã³ã®ãã¹ã¯äŸã®ãã¹ã§ç€ºãã察å¿ãåœãã£ãŠãããªãè¡ãå
ã®èª€ããšããŠæ¡å
ãã
|
|
521
|
+
- **ããŠã³ããããã¹ã®æ±ºãæ¹**ïŒ`src/core/preflight/hostPaths.ts` ã® `resolveHostPaths`ã261115-d0n30ïŒ: Docker ã®ã³ã³ããã«
|
|
522
|
+
ããŠã³ããããã®ãã·ã³ã®ãã¹ããDocker ã®ããŒã¢ã³ããèŠããã¹ã«æ±ºãããæ±ããçµæã¯å人èšå®ã«æžãããæ¯åæ±ããã
|
|
523
|
+
ããã§ Docker ã«åºãã®ã¯ `docker inspect` ã ãïŒ`dockerExec` ã®æéã®äžéãšåæ¶ãåŒæ°ã¯é
åïŒã§ãå
šéšã®å¯Ÿè±¡ã決ãŸãåã«ããŠã³ããã
|
|
524
|
+
ã³ãã³ãã¯åºããªãã1ã€ã§ã決ãŸããªããã° `ok: false` ã§ãåŒã¶åŽã¯ã³ã³ãããèµ·ãããªã
|
|
525
|
+
|
|
526
|
+
| p3 ãåããŠããå Žæ | æã§æžãã察å¿ïŒ`codex.pathMap`ïŒãåœãã察象 | åœãããªã察象 |
|
|
527
|
+
| --- | --- | --- |
|
|
528
|
+
| ã³ã³ããã®å€ïŒ`/proc/self/mountinfo` ã«èªåã®ã³ã³ããã® ID ãç¡ãã`/.dockerenv` ãç¡ãïŒ | 察å¿ã®ãšãã | 倿ããªãïŒ`direct`ïŒãDocker Desktopã»WSLã»ãªã¢ãŒãã® Docker ã§ããä»ãŸã§ã©ãããã®ãŸãŸæž¡ã |
|
|
529
|
+
| ã³ã³ããã®äžã§ãèªåã®ã³ã³ããã確ããããã | èªåã®ããŠã³ãããæ±ãããã®ãšåããªããã®å¯Ÿå¿ãéãã°æ¢ããïŒ`conflict`ïŒ | èªåã®ããŠã³ãããæ±ããïŒ`auto`ïŒãæ±ããããªããã°æ¢ãã |
|
|
530
|
+
| ã³ã³ããã®äžã§ãèªåã®ã³ã³ããã確ãããããªã | 察å¿ã®ãšããïŒç¢ºãããŠããªãå° `verified: false`ïŒ | æ¢ãã |
|
|
531
|
+
|
|
532
|
+
- èªåã®ã³ã³ãã: `/proc/self/mountinfo` ã®ãã¡ DockerïŒãš PodmanïŒãã³ã³ããããšã«çœ®ããã®ïŒ`/etc/hostname`ã»`/etc/hosts`ã»
|
|
533
|
+
`/etc/resolv.conf`ïŒã®å
ã®å Žæã«ãã 64 æ¡ã® ID ãšãcgroup v1 ã® docker ã®è¡ãåè£ã«ããæ¥ç¶å
ã®ããŒã¢ã³ã®
|
|
534
|
+
`docker inspect --type container` ã§ `Id` ãåããã®ãæ¢ããæ¥ç¶å
ïŒ`DOCKER_HOST`ã»`DOCKER_CONTEXT`ã»éžãã§ãã contextïŒã¯
|
|
535
|
+
åŸã§ `docker run` ãããšããšåã docker ã® CLI ã«ä»»ããïŒæ¥ç¶å
ã®ããŒã¢ã³ã«èªåãå±
ãã°ããã®ããŒã¢ã³ãã³ã³ãããäœãïŒã
|
|
536
|
+
ãã¹ãåã ãã»åè£ã®å
é ã ãã§ã¯æ±ºããªããèŠã€ãããªãïŒ`self-not-found`ããªã¢ãŒãã»å¥ã®ããŒã¢ã³ïŒãè€æ°ïŒ`self-ambiguous`ïŒã
|
|
537
|
+
inspect ã®ãã¹ãåããã®ãã·ã³ãšéãïŒ`self-mismatch`ïŒãåãåããã®å€±æã»æéåãïŒ`inspect-failed`ïŒãID ãåãããªã
|
|
538
|
+
ïŒ`self-unknown`ïŒã¯èªåã§ã¯æ±ºããªã
|
|
539
|
+
- 1ã€ã®ãã¹: 察象ã®å®äœïŒã·ã³ããªãã¯ãªã³ã¯ã蟿ã£ãå
ãç¡ããšããã¯åšããšãããŸã§èŸ¿ã£ãŠæ®ããè¶³ãïŒãå«ã **äžçªæ·±ã** ããŠã³ãã
|
|
540
|
+
mountinfo ããéžã³ãããã inspect ã® `Mounts` ã® `Type: bind` ã® `Destination` ã®ãšãã ãããã® `Source` ã«æ®ããè¶³ãã
|
|
541
|
+
volumeã»tmpfsã»Docker ã®ç¥ããªãããŠã³ãã®äžïŒ`not-bind`ïŒããã©ã®ããŠã³ãã®äžã§ããªãïŒã³ã³ããã®å±€ã`container-layer`ïŒã¯ã
|
|
542
|
+
芪㮠bind ã«éããã«æ¢ããã`Source` ã `/` ã§å§ãŸããªã圢ïŒ`unsupported-source`ïŒãæ¢ããã`Source` ã¯åãããŒã¢ã³ãè¿ãã
|
|
543
|
+
ãã®ã§ãåãããŒã¢ã³ã«ãã®ãŸãŸæž¡ããïŒDocker Desktop ã®äžã® DevContainer ã§ããDesktop ãèŠåããŠæ¢ããããšã¯ããªãïŒ
|
|
544
|
+
- æã§æžãã察å¿ã¯ä»ãŸã§ã©ããåããé ã®å¢çäžèŽïŒ`mapPath`ïŒã§ãå
ã®ãã¹ïŒå®äœã§ã¯ãªãïŒã«åœãŠããèªåã§æ±ãããã®ãšé£ãéãã°
|
|
545
|
+
æã®å¯Ÿå¿ã§äžæžãããã«æ¢ããïŒééã£ãè¡ãå
ããã¹ãã«åšããšãéããã©ã«ããããŠã³ãããŠããŸãããïŒ
|
|
546
|
+
- ã³ã³ããã®å€ã§å€æããªãã®ã¯ã以åããã®å©çšè
ïŒMac ã® Docker Desktopã»WSL ã§çŽæ¥åãããåããã¹ã§ããŠã³ãã§ããŠããïŒã
|
|
547
|
+
æ¢ããªãããããªã¢ãŒãã® Docker ãå€ãã䜿ããšãã以åãšåãããã®ãŸãŸæž¡ãïŒèŠããªãæã§æžãïŒ
|
|
548
|
+
- æ¢ããçç±ããšã«æ¬¡ã«ããããšïŒ`nextStep`ïŒã1ã€æ·»ãã: ããŠã³ãã®çš®é¡ã®åé¡ã¯ãã©ã«ãã bind ã®äžãžç§»ããé£ãéãã¯æã®å¯Ÿå¿ã
|
|
549
|
+
çŽããå€ããåãåããã®å€±æã¯ `docker version`ããã以å€ã¯æã§å¯Ÿå¿ãæžã
|
|
550
|
+
- 䜿ããšãã: PreflightïŒ`CodexWorkspaceEngine.runWith`ãå
šéšã®åç
§å
ãšããŒã¿ããCodex ã®ã³ã³ãããèµ·ããåã«ãŸãšããŠæ±ºããïŒã
|
|
551
|
+
åç
§å
ãèªã askïŒãªãªãŒã¹ããŒãã®èŠçŽã»ã¬ãã¥ãŒïŒãæç»ïŒ`renderHtml`ãå®éã«ããŠã³ãããäžæã® `in`ã»`out` ããæç»ã®
|
|
552
|
+
ã³ã³ãããèµ·ããåã«æ±ºãããPreflight ã®åŸã»æå
ã®è©äŸ¡ã®åã蟌ã¿ã»`p3 render` ã®å
šéšïŒãåæã§ãã¹ã倿ããå£ïŒä»¥åã®
|
|
553
|
+
`hostPath`ïŒã¯æããªãïŒèªåã§æ±ºãããšèª€ã£ãŠèªãŸããªãããã«ïŒãæå
ã®è©äŸ¡ã§åçš¿ãç¡ããšãã»Mockã»èŠæãšã¿ã¹ã¯ã®æäœã¯ Docker ã«
|
|
554
|
+
åãåãããªã
|
|
555
|
+
- 決ãŸããªããšãã®ãšã©ãŒãšéå§ã®ãã°ïŒå
±æã®èšé²ïŒã«ã¯ã察象ã®ååïŒåç
§å
appã»ããŒã¿ã»æç»ã®åçš¿ïŒã»çç±ã»æ¬¡ã«ããããšã»
|
|
556
|
+
æ±ºãæ¹ïŒèªå / æã®å¯Ÿå¿ / 倿ãªãïŒã ããæžãããã®ãã·ã³ã®ãã¹ã»ãã¹ãã®ãã¹ã»èªåã®ã³ã³ããã® IDã»inspect ã®äžèº«ã¯æžããªãã
|
|
557
|
+
å®éã®ãã¹ã¯ããã®ãã·ã³ã§ `p3 user-config paths <ãã¹>...`ïŒèªãã ãããããžã§ã¯ããæ±ºããåã«åãïŒã§èŠãããšã©ãŒã¯ãã®
|
|
558
|
+
ã³ãã³ããžæ¡å
ãã
|
|
559
|
+
- æå
ã®è©äŸ¡ã®åã蟌ã¿ã§å人èšå®ïŒãã¹ã®å¯Ÿå¿ïŒãèªããªããšãã¯ã空ã®å¯Ÿå¿ã§æããã«ãæããªãã£ãçç±ãšããŠæ®ãïŒè©äŸ¡ã¯æ®ãïŒ
|
|
560
|
+
- `P3_HOST_PATHS=direct` ã¯èªåã§æ±ºãããã³ã³ããã®å€ãšåãã«æ±ãïŒæã§æžãã察å¿ã ãïŒããã¹ãïŒ`vitest.config.ts`ïŒãã
|
|
561
|
+
ãã¹ããåãããã·ã³ã DevContainer ãã©ããã§çµæãå€ããªãããã«äœ¿ããèªåã®ã³ã³ããã®ããŠã³ãã䜿ããã¹ãã¯
|
|
562
|
+
`hostProbe`ïŒ`HostPathProbe`ïŒãæž¡ã
|
|
521
563
|
- æ§æ¥ã®èªèšŒã® auth.json ã¯ãP3 ã®ã€ã¡ãŒãžã®äžã® CodexïŒ`CODEX_HOME=/codex`ïŒã§ `codex login --device-auth` ããã°ãããªã¥ãŒã ã®
|
|
522
564
|
äžçªäžã«ã§ãããã®ãŸãŸ `authVolume`ïŒ`volume-subpath=auth.json`ïŒã§äœ¿ããïŒãµã€ã³ã€ã³ãã®ãã®ã¯äººãè¡ãïŒã`authFile` 㯠Docker ã®ãã¹ãã®ãã¹ã§
|
|
523
565
|
æž¡ãã®ã§ `codex.pathMap` ã¯å¹ããªã
|
|
@@ -724,6 +766,28 @@ AI ãšãŒãžã§ã³ããšé²ããéçºããèŠæãåãã â äœãäœã
|
|
|
724
766
|
| åºã | ãªãªãŒã¹ããŒãïŒå€æŽã®èšé²ããèŠçŽã®æ¡ãäœãã人ãçŽããŠä¿åã»åºåããïŒããã€ã«ã¹ããŒã³ã®ãªãªãŒã¹æžã¿ã®å°ãèŠæã®äžæ¬å®äºæž | èŠçŽã®æ¡ã¯ P3 ããåŒã¶ CodexïŒæã§æžããŠãããïŒãä¿åã»ãªãªãŒã¹æžã¿ã»äžæ¬å®äºã¯äººãããŒãžã»å
¬éã»ãããã€ã¯å©çšè
ã®æå
ãšå€éšã®ä»çµã¿ | `release-notes/<ãã€ã«ã¹ããŒã³ID>.md`ïŒçæããæ¡ã¯ã¡ã¢ãªã®äžã ãã§ãä¿åãããŸã§ãã¡ã€ã«ã«ãªããªãïŒããªãªãŒã¹æžã¿ã¯ `project.yaml`ãå
¬éç©ã¯ P3 ã®ããŒã¿ã®å€ |
|
|
725
767
|
| æ¯ãè¿ã£ãŠæ¬¡ã«æŽ»ãã | ãã€ã«ã¹ããŒã³ã¬ãã¥ãŒïŒç®çã»äºå®æ©èœã»åè³ªåºæºã«å¯ŸããŠã³ãŒããšå±¥æŽãèªãåèã®èšé²ïŒãå質ã®äžè¶³ããã®æ¹åèŠæã®åçš¿ã倿Žã®èšé²ãšéå»ã® run ãæ¬¡ã® Preflight ã調ã¹ã | ã¬ãã¥ãŒã¯ P3 ããåŒã¶ Codexãæ¹åèŠæã»æ¬¡ã®èŠæã¯äººãæå
ã® AI ãšãŒãžã§ã³ããæç€ºããŠç»é²ããïŒèªåã§ã¯äœããªãïŒ | `milestone-reviews/<ãã€ã«ã¹ããŒã³ID>/<run>/`ã`quality-improvements.json`ã倿Žã®èšé²ã¯ `<èŠæ>/tasks/Txxx.md` |
|
|
726
768
|
|
|
769
|
+
### 代衚çãªæµããšãæ ¹æ ã远ãããšããããš
|
|
770
|
+
|
|
771
|
+
README ã®ãèŠæ±ã»å€æã»å®è£
ã»æ€èšŒãã€ãªãããã®æ ¹æ ãåŸãã远ãããã¯ãäžã®è¡šã1æ¬ã®æµããšããŠèªãã ãã®ã代衚çã«ã¯æ¬¡ã®ããã«ã€ãªããã
|
|
772
|
+
|
|
773
|
+
èŠæ â Preflight â å®è£
ïŒP3 ã®å€ïŒâ ã¿ã¹ã¯ã®ã¬ãã¥ãŒ â ãã€ã«ã¹ããŒã³ã¬ãã¥ãŒ â 人ã®å€æ
|
|
774
|
+
|
|
775
|
+
- **å¿
é ã®é çªã§ã¯ãªã**: Preflight ãã¬ãã¥ãŒãä»»æã§ãèŠæããçŽæ¥ã¿ã¹ã¯ãäœã£ãŠãããïŒ[Preflight ãéããã«ã¿ã¹ã¯ãäœã](how-to-use.md#preflight-ãéããã«ã¿ã¹ã¯ãäœã)ïŒã
|
|
776
|
+
確ãããŠäœãçŽãã»æ¯ãè¿ã£ãŠèŠæãè¶³ãããã«è¡ãæ¥ãããã€ã«ã¹ããŒã³ã¬ãã¥ãŒã¯äœåºŠã§ãå®è¡ã§ãããç¶æ
ã®é·ç§»ã§ããªã
|
|
777
|
+
- **人ã®å€æã¯æåŸã ãã§ã¯ãªã**: æ¡ã®æ¡çšïŒã¿ã¹ã¯åïŒã»æžã¿ã»èŠæã®å®äºæžãšèŠéãã»ãªãªãŒã¹ãããããããããã®æç¹ã§äººã決ãã
|
|
778
|
+
- **確ãããåäœã2ã€ãã**: ã¿ã¹ã¯ã®ã¬ãã¥ãŒã¯ã¿ã¹ã¯ããšã«åãå
¥ãåºæºãšåè³ªåºæºãèŠãïŒ[ã¿ã¹ã¯ã® AI ã¬ãã¥ãŒ](how-to-use.md#ã¿ã¹ã¯ã®-ai-ã¬ãã¥ãŒ)ïŒã
|
|
779
|
+
ãã€ã«ã¹ããŒã³ã¬ãã¥ãŒã¯ãã€ã«ã¹ããŒã³å
šäœã§ãç®çãšäºå®æ©èœãæãããããèŠãïŒ[ãã€ã«ã¹ããŒã³ã¬ãã¥ãŒ](how-to-use.md#ãã€ã«ã¹ããŒã³ã¬ãã¥ãŒ)ïŒ
|
|
780
|
+
- **æ€èšŒã®æ
åœ**: ãã¹ãã»åäœç¢ºèªã¯äœæ¥ããåŽãè¡ããP3 ã¯å®è¡ããªããP3 ã«æ®ãã®ã¯äœæ¥ããåŽã®ç³åïŒèšŒæ ïŒãšãAI ã®ã¬ãã¥ãŒã®åèã®èšé²
|
|
781
|
+
|
|
782
|
+
ãæ ¹æ ãåŸãã远ãããã¯ã次ã®ãã®ãåŸããéããŠèªããããšãæãã
|
|
783
|
+
|
|
784
|
+
- èŠæã®æ¬æãšæ·»ä»ãPreflight ã®åºå®ããè©äŸ¡å¯Ÿè±¡ã»å€å®ã»ç¢ºãããæ ¹æ ãšæšæž¬ã®åºå¥ã»ã¿ã¹ã¯æ¡
|
|
785
|
+
- ã¿ã¹ã¯ã®åãå
¥ãåºæºã»ææç©ïŒã³ãããã PR ã® URL ãªã©ïŒã»å€æŽã®èšé²ã»åºæºããšã®èšŒæ
|
|
786
|
+
- ã¬ãã¥ãŒã®åºå®ããææïŒå·®åã»è³æïŒãšçµæ
|
|
787
|
+
|
|
788
|
+
æžãããªãã£ã倿ã®çç±ããP3 ã®å€ã§èµ·ããããšïŒãã¹ãã®åºåãã®ãã®ã»äŒè©±ïŒã¯æ®ããªããæ£ãããä¿èšŒãããã®ã§ã¯ãªãã確ãããããã®
|
|
789
|
+
ææãåãå Žæã«ãããããã®ã
|
|
790
|
+
|
|
727
791
|
### P3 ãæå³ããŠæããªããã®
|
|
728
792
|
|
|
729
793
|
- **ã¿ã¹ã¯ã®äœæ¥ã AI ã«å®è¡ããã圹**ïŒäœæ¥ã®å®è¡ã»äžŠã¹ãŠã®å®è¡ã»ãšãŒãžã§ã³ãã®å²ãåœãŠïŒãäœæ¥ã¯å©çšè
ãéžãã æå
ã®ãšãŒãžã§ã³ãã§
|
|
@@ -774,7 +838,14 @@ src ã¯5ã€ã®å±€ã«åããäŸåã®åãã `test/layers.test.ts` ã§ç¢ºã
|
|
|
774
838
|
| ã¿ã¹ã¯ã® AI ã¬ãã¥ãŒïŒææã»å±¥æŽïŒ | `core/taskReview/`ïŒ`material.ts`ã»`store.ts`ïŒ |
|
|
775
839
|
| ãããžã§ã¯ãã®åè³ªåºæºïŒç¶æ
ã»ID ã®æ¯ãæ¹ã»æäœã»ãã³ãã¬ãŒããšæ¹çã®å·®åã»çïŒ | `shared/quality.ts`ã»`shared/qualityTemplates.ts`ïŒä¿å㯠`core/quality.ts` ãš `Workspace.writeQuality`ïŒ |
|
|
776
840
|
| äœæ¥äžã®ã¿ã¹ã¯ã®æ¢ãŸã£ãŠããçç±ïŒåæ¢ãä»ããã»çŽãã»è§£é€ã»å±¥æŽã»æ¢ãŸã£ããŸãŸã®ç§»åã®æåŠã»å£ããå€ã®èªã¿æ¹ïŒ | `shared/taskBlock.ts`ïŒä¿åãšç¶æ
ãšã®çªãåãã㯠`core/requestOps.ts` ã® `updateTask`ãéèšã¯ `core/ops.ts`ïŒ |
|
|
777
|
-
| ã¿ã¹ã¯ã®åãå
¥ãåºæºãšèšŒæ ïŒID
|
|
841
|
+
| ã¿ã¹ã¯ã®åãå
¥ãåºæºãšèšŒæ ïŒID ã®æ¯ãæ¹ã»æäœã»å€±å¹ã»æ ¹æ ã®çš®é¡ã»äžè¶³ã»å£ããå€ã®èªã¿æ¹ïŒãšæžã¿ã®è§£é€ | `shared/acceptance.ts`ïŒæžã¿ã®è§£é€ãšä¿å㯠`core/requestOps.ts` ã® `updateTask`ïŒ |
|
|
842
|
+
| èŠæ±ã®åºå
žãšç¢ºèªïŒæ ¹æ ã®èšé²ã»ç¢ºèªã®èŠä»¶ãšç¶æ
ã»å€æŽã§ã®å€±å¹ã»åçã»ç¢ºèªäºé
ã®èªã¿æ¹ã»è©äŸ¡ã®è³æïŒãšãå£ããå€ã®èªã¿æ¹ | `shared/requirementSource.ts`ïŒèŠæã®ä¿å㯠`core/requestOps.ts` ã® `updateRequirement`ã»`saveClarifyAnswer`ãåºæºã®èšé²ã¯ `shared/acceptance.ts` ã® `source` æäœãè©äŸ¡å¯Ÿè±¡ã®åºå®ãšæ¯èŒã¯ `core/preflight/input.ts`ïŒ |
|
|
843
|
+
| ã¿ã¹ã¯ã®ææ»ãã®å±¥æŽïŒæžã¿ã®è§£é€ã»å®äºããã®åéã®å¥æ©ã»1æäœ1ä»¶ã»å£ããå€ïŒ | `shared/reworkHistory.ts`ïŒä¿å㯠`core/requestOps.ts` ã® `updateTask`ïŒ |
|
|
844
|
+
| èŠæã®æ¯ãè¿ãïŒå¯Ÿè±¡ã®åè£ã»ç¢ºå®ãšèšæ£ã»èšé²ã®èªã¿æ¹ïŒ | `shared/retrospective.ts`ïŒä¿å㯠`core/retrospective.ts`ïŒ |
|
|
845
|
+
| éçºã®ææšïŒå®çŸ©ã»å¯Ÿè±¡ã»ç®åºã»æ¬ æã®æ±ãã»ç¯å²ïŒãšäººãèšé²ããå€ | `core/metrics/definitions.ts` ã® `METRIC_DEFINITIONS`ïŒç¯å²ãšææã¯ `core/metrics/index.ts`ã人ã®èšé²ã®ä¿å㯠`core/metrics/manual.ts`ãå㯠`shared/metrics.ts`ïŒ |
|
|
846
|
+
| èŠæãšãã®ã¿ã¹ã¯ã®ä¿åã®ããã¯ïŒå¥ã®ããã»ã¹ãšã®èªã¿çŽãã»æžãã»ç§»ãã®æä»ïŒ | `core/store/collection.ts` ã® `lock`ã»`core/store/workspace.ts` ã® `requestLock` |
|
|
847
|
+
| å®äºã®èšé²ïŒå¥æ©ã»åãæ¡ä»¶ã»ID ã®æ¯ãæ¹ã»èªã¿æ¹ã»å£ããå€ïŒãšåç
§å
ã®ååŸ | `shared/completionRecord.ts`ïŒä¿å㯠`core/requestOps.ts` ã® `createTask`ã»`updateTask`ã»`updateRequest`ãåç
§å
ã®ã³ãããã®ååŸã¯ `core/completionRefs.ts`ïŒ |
|
|
848
|
+
| èŠçŽããå¿
èŠïŒåè£ïŒã®èšºæïŒåºç¹ã»çç±ã®çš®é¡ã»é¢ä¿ã®ç¯å²ïŒãšåæã®å€æŽã®èšé² | `shared/reviewCandidate.ts`ïŒèªã¿åãã»éèšã¯ `core/reviewCandidates.ts`ãåæã®å€æŽã®ä¿å㯠`core/requestOps.ts` ã® `recordPremise`ïŒ |
|
|
778
849
|
| ãªãªãŒã¹ããŒãïŒææã®èŠåã»ä¿åã»åºåã»èŠçŽã®çæã»èŠæã®äžæ¬å®äºïŒ | `core/releaseNotes/`ïŒ`material.ts`ã»`store.ts`ã»`service.ts`ã»`generate.ts`ã»`completeRequests.ts`ïŒ |
|
|
779
850
|
| ã¿ã¹ã¯ã®é¢ä¿ïŒ`depends_on`ã»`supersedes` ã ããåãèŠæã®äžãPreflight ã®ã¿ã¹ã¯åã ãã匵ãïŒ | `shared/types.ts` ã® `RELATION_TYPES`ã»`core/preflight/service.ts` ã® `materialize` |
|
|
780
851
|
| ãããžã§ã¯ããè·šã serveïŒç»é²ã®äžèЧã»ç»é²äžä»£ã»æèã®ééïŒ | `core/projectRegistry.ts`ïŒAPI 㯠`server/api/projectsRoutes.ts`ïŒ |
|
|
@@ -920,6 +991,11 @@ API ã® PATCHã`rev` ã§æ¥œèгããã¯ïŒãæžãæããŠãç¶æ
ã»æ¢å
|
|
|
920
991
|
- **åè©äŸ¡**: ãã€ãã©ããååã®çµæãšã¡ã¢ãåŒãç¶ããååã®è©äŸ¡ã®ããšã§ã¿ã€ãã«ã»æ¬æãå€ãã£ãŠããã°ã`carryover.md` ã«
|
|
921
992
|
ãååã®è©äŸ¡ã®ããšã§å€ãã£ãèŠæããšããŠååã®æç¹ã®å
å®¹ãæžããè©äŸ¡ã®åºæºã¯ä»ã®èŠæã§ãååã®è©äŸ¡ã»æ¡ã»ã¡ã¢ãšã®é£ãéãã¯
|
|
922
993
|
確èªäºé
ã«å
¥ãããããçœçŽã®åè©äŸ¡ãå±¥æŽã®æ¶å»ã¯äœããªãïŒååãåŒãç¶ãããããªããã°ãã¡ã¢ã§ããæžãïŒ
|
|
994
|
+
- **èŠæ±ã®åºå
žãšç¢ºèª**: èŠæã®æ ¹æ ã®èšé²ïŒ`requirementSources`ïŒãšç¢ºèªäºé
ãžã®åçïŒ`clarifyAnswers`ïŒã `input.requirement` ã«åºå®ãã
|
|
995
|
+
`request.md`ïŒæ¬æã®åŸã« P3 ãåºå®ããè³æãšããŠïŒãšãšã³ãžã³ãžã®äŸé Œæã«åãå
容ãå
¥ãããæ¯ã¹ããšãã¯èšé²ã®æ¥æã»ä¿åè
ãé€ããäžèº«ã§ã
|
|
996
|
+
å€ããã° `changed` ã« `requirement`ã`input.requirement` ã®ç¡ã以åã® run ã¯ãä»ã®èŠæã«ãèšé²ã»åçãç¡ããã°åããšã¿ãªããããã°å€ãã£ã
|
|
997
|
+
ãšã¿ãªããåºå®ããå€ãå£ããŠããã° unknownïŒä»¥åã® run ã¯æžãæããªãïŒãåã®èŠæã® hashïŒ`inputHash`ïŒã«ããèšé²ã»åçããããšãã ãè¶³ã
|
|
998
|
+
ïŒç¡ããã°ä»¥åãšåãå€ïŒãä»ã®èŠæã®èšé²ã»åçãèªããªããã° Preflight ãå§ããªã
|
|
923
999
|
- **éç**: æ¯ã¹ãã®ã¯ãå§ãããšãããšãã¿ã¹ã¯åã®çŽåããã¿ã¹ã¯åã®éäžã«å¥ã®ããã»ã¹ãæ¬æãæžãæããããšãŸã§ã¯æä»ããªã
|
|
924
1000
|
ïŒåãèŠæãåæã«è§Šããšãã®èª¿æŽã¯ããããŸã§ã©ãã人ãè¡ãïŒ
|
|
925
1001
|
- **æ»ãæ¹**: å€ãè©äŸ¡ã§ã¿ã¹ã¯åããããšãã¯ãèŠæãè©äŸ¡ããæç¹ã®å
容ïŒ`request.md`ïŒã«æ»ããä»ã®å
容ã§ãããã°åè©äŸ¡ãã
|
|
@@ -928,6 +1004,38 @@ API ã® PATCHã`rev` ã§æ¥œèгããã¯ïŒãæžãæããŠãç¶æ
ã»æ¢å
|
|
|
928
1004
|
ããªããã° baseRev ãé²ããå€ãã£ãŠããã°ç«¶åãšããŠç¥ãããïŒãæªä¿åã®ã¿ã€ãã«ã»æ¬æãããé㯠Preflight ã®å®è¡ãšã¿ã¹ã¯åãæ¢ããã
|
|
929
1005
|
ã¿ã¹ã¯åã® 409 㯠`code` ã§åããïŒ`stale_input` ã¯ãµãŒãã®çç±ããã®ãŸãŸã`rev_conflict` ã¯çœ®ãæãã®åè£ã®èªã¿çŽãïŒ
|
|
930
1006
|
|
|
1007
|
+
### èŠæ±ã®åºå
žãšç¢ºèª
|
|
1008
|
+
|
|
1009
|
+
å€éšã®è©äŸ¡ïŒèª²é¡ BïŒãžã®å¯Ÿå¿: èŠæ±ãã®ãã®ãééã£ãŠããå Žåããªããžããªãšå±¥æŽãèªãã§ãæ£è§£ã¯åãããªããPreflight ã«ã¯ç¡çã«æ£è§£ã
|
|
1010
|
+
åºããããæ ¹æ ãè¶³ããªãããšãšèª°ã«äœã確ããããã瀺ãããå®è£
ããç¬ç«ããæ£è§£ã®æ ¹æ ãäººãæ®ããããã«ããïŒ`shared/requirementSource.ts`ïŒã
|
|
1011
|
+
|
|
1012
|
+
- **æã¡ç©**: èŠæã® `requirementSources`ïŒ`[{id: S1, target?, source?, basis?, confirmed?, history?, recordedAt, recordedBy}]`ïŒã»`requirementSeq`ã»
|
|
1013
|
+
`clarifyAnswers`ãã¿ã¹ã¯ãšã¿ã¹ã¯æ¡ã® `acceptanceSources`ïŒåãèšé²ã« `criterionId`ãåºæºã®äžã§ã¯ãªãå¥ã«æã€ã®ã§ãid ãš text ã§åºæºãçµã¿çŽã
|
|
1014
|
+
æ§ç»é¢ã»æ§ CLI ã®ç·šéã§ãæ¶ããªãïŒãã©ããä»»æã§ãç¡ãã®ã¯æªèšé²ãæ¢åã®åè³ªåºæºã®åºå
žïŒ`quality`ïŒã»å®è£
åŸã®èšŒæ ã® `basis`ã»AI ã®èª¿ã¹ãç®æ
|
|
1015
|
+
ïŒ`PreflightAssessment.evidence`ïŒãšã¯å¥ã®ãã®
|
|
1016
|
+
- **確èª**: `confirmed` ã¯ç¢ºããã人ïŒåœ¹å²åã»ã¢ã¯ã¿ãŒåã®æååïŒã»æ¥ïŒå©çšè
ãæžã `YYYY-MM-DD`ïŒãšã確èªãããšãã®å¯Ÿè±¡æã»åºå
žã»æ ¹æ ã»
|
|
1017
|
+
察象ïŒèŠæã®é¡ã𿬿ãåºæºã®æïŒã® hash ãåºå®ããã確èªã®èšé²ã«ã¯åºå
žã»æ ¹æ ã»äººã»æ¥ãèŠãïŒäžæžãã¯èŠããªãïŒãä¿åã®æäœè
ïŒ`recordedBy`ã»
|
|
1018
|
+
`updatedBy`ïŒã¯æ¥åäžã®ç¢ºèªè
ãšå¥ã«æ®ã
|
|
1019
|
+
- **ç¶æ
**ïŒå
±é颿° `sourceState`ã»`overallState`ïŒ: æªèšé² / æªç¢ºèª / 確èªèšé²ãã / å確èªãå¿
èŠ / 察å¿å
äžæãä¿åãããã³ïŒèŠæã®é¡ã»æ¬æã
|
|
1020
|
+
èšé²ãåºæºã®æã®å€æŽïŒã«ã確èªãããšããšéã確èªã `history` ãžç§»ãïŒ`settleSources`ïŒãã ããæãå
ã«æ»ããŠã確èªèšé²ããã«æ»ããªãã
|
|
1021
|
+
çŽæ¥ç·šéã§äžèº«ã ãå€ããå Žåããæ¯ã¹ããšéãã®ã§å確èªãå¿
èŠãšåºããåºæºãæ¶ããèšé²ã»åããå
ã®ç¡ãèšé²ã¯å¯Ÿå¿å
äžæãšããŠæ®ã
|
|
1022
|
+
- **åã**: åºæºã®èšé²ã¯èŠæã®èšé²ã `from` ã§åããïŒå
容ã ãã確èªã¯åŒãç¶ããªãïŒãã¿ã¹ã¯åïŒ`criteriaForTask`ïŒã§ã¯ `from` ã®èšé²ã
|
|
1023
|
+
æ¡çšãããšãã®èŠæã®èšé²ã®å
容ã«åãçŽããèŠæå
šäœã®ç¢ºèªãå
šéšã®åºæºãžèªåã§åŒãç¶ããªã
|
|
1024
|
+
- **確èªäºé
ãšåç**: è©äŸ¡ã¯ä»¥åã® `questions`ïŒæã®äžŠã³ïŒã«å ã㊠`clarifications`ïŒ`[{id: Q1, target, ask, question, needed, impact}]`ïŒã
|
|
1025
|
+
åºããã確èªå
ãåãããªããã° `ask` ã¯ãèŠæè
ã«ç¢ºèªå
ãç¹å®ããŠãããããå£ããé
ç®ã¯æšãŠãã« `clarificationProblems` ã«æ®ãïŒCodex ã®
|
|
1026
|
+
åã蟌ã¿ã¯ãã°ã«ãåºãïŒãæå
ã®ãšãŒãžã§ã³ãã®åã蟌ã¿ã§ã¯çŽããŸã§ç¢ºå®ããªããåçã¯èŠæã® `clarifyAnswers` ã«ãå
ã® run ãšç¢ºèªäºé
ã® IDã»
|
|
1027
|
+
質åã®åãã»åçã»åçããäººã»æ¥ã»åºå
žã»æ ¹æ ã»å¯Ÿå¿ããèšé²ïŒ`links`: ID ãšå
容㮠hashïŒã§æ®ããéå»ã® run ãšè©äŸ¡ã¯æžãæããªãã
|
|
1028
|
+
ç¶æ
ã¯åçæžã¿ / æªåç / å確èªãå¿
èŠïŒå¯Ÿå¿ããèšé²ã®å
容ãå€ãã£ãïŒ/ åç
§å
äžæãæ¬¡ã® run ã®åã質åãžæåã®äžèŽã§ç§»ããªã
|
|
1029
|
+
- **責任ã®å¢ç**: èšé²ã»ç¢ºèªã»åçã¯ã©ãã人ïŒãšäººã«é ŒãŸãã AIïŒã®ç³åã§ãP3 ã¯æ¥åã®å¥çŽã»æ¿èªè
ã®æš©éã»æ¬äººæ§ã確ãããªãã
|
|
1030
|
+
確èªèšé²ãã㯠P3 ã®ä¿èšŒã§ã¯ãªããAI ã®è©äŸ¡ã»å®è£
ã® `met`ã»äººã®æžã¿ã»åçã®ä¿åã§ã¯ç¢ºèªèšé²ããã«ãªããªããæ ¹æ ã®äžè¶³ã§å®äºã»æžã¿ã¯æãŸãªãã
|
|
1031
|
+
åçã»åºå
žã»åŒçšã¯è³æãšããŠæž¡ããäžã® URLã»æ·»ä»ãåãã«è¡ããªã
|
|
1032
|
+
- **倿Žã®å¥çŽ**: èŠæã®èšé²ã¯æäœïŒ`add` / `edit` / `confirm` / `remove`ïŒã§ã ãå€ããïŒPATCH ã®å€ã¯ç¡èŠããïŒãæäœã¯æžãçŽåã«èªã¿çŽããå€ã«
|
|
1033
|
+
é ã«åœãŠã1ã€ã§ãèŠåã«åããªããã°äœãæžããªãïŒ`RequirementInputError`ãAPI 㯠400 `requirement_invalid`ïŒãåãå€ã®åä¿åã¯æžããªãã
|
|
1034
|
+
`rev` ã®ç«¶å㯠409ãã¿ã¹ã¯ã®èšé²ã¯åãå
¥ãåºæºã®æäœïŒ`{op: "source", id, source}`ïŒã§ãäžèº«ãå€ããã°æžã¿ãå€ããã¿ã¹ã¯æ¡ã¯ `sourceOps` ãš
|
|
1035
|
+
`expectedSources`ïŒæ ¹æ ã ãã®ç·šéã®ç«¶åãèŠãïŒãå£ããå€ã¯çç±ãåºããé¢ä¿ã®ãªãæŽæ°ã§ã¯å
ã®å€ã®ãŸãŸæžãæ»ãïŒèŠæã¯ `keepRaw`ã
|
|
1036
|
+
ã¿ã¹ã¯ã¯åãå
¥ãåºæºãšåããã¿ã¹ã¯æ¡ã¯å
ã®å€ãæžãæ»ãïŒ
|
|
1037
|
+
- **è©äŸ¡ã®è³æ**: äžã®ãè©äŸ¡å¯Ÿè±¡ã®åºå®ããã¿ã¹ã¯ã® AI ã¬ãã¥ãŒã®ææã«ããåºæºããšã®èšé²ãšç¶æ
ãå
¥ããïŒææã® hash ã«å
¥ãïŒ
|
|
1038
|
+
|
|
931
1039
|
### 眮ãæããããã¿ã¹ã¯
|
|
932
1040
|
|
|
933
1041
|
åè©äŸ¡ã§ã¿ã¹ã¯åãããšãæ°ããæ¡ãåãèŠæã®å€ãã¿ã¹ã¯ã眮ãæããïŒ`supersedes`ïŒããšãããã
|
|
@@ -973,6 +1081,121 @@ API ã® PATCHã`rev` ã§æ¥œèгããã¯ïŒãæžãæããŠãç¶æ
ã»æ¢å
|
|
|
973
1081
|
- 埩å
ã»ç·šéã»ã¢ãŒã«ã€ãããèŠæã®äžã®ã¿ã¹ã¯ã®é²èЧã¯ããªããéå»ã«ä¿åããã¬ãã¥ãŒã»ãªãªãŒã¹ããŒãã»git ã®å±¥æŽã¯æ¶ããªã
|
|
974
1082
|
èŠæã®è©³çŽ°ãš ã¿ã¹ã¯ã® GET ã¯å° `superseded` ãè¿ãã
|
|
975
1083
|
|
|
1084
|
+
### ææ»ãã®å±¥æŽãšä¿åã®ããã¯
|
|
1085
|
+
|
|
1086
|
+
ã¿ã¹ã¯ã®æžã¿ã®è§£é€ãšå®äºããã®åéã `reworkHistory`ïŒ`[{id: R1, at, by, rev, cause, unchecked, reopened, from, to}]`ã远èšã ãïŒã«æ®ã
|
|
1087
|
+
ïŒ`shared/reworkHistory.ts`ïŒãåŸã§ãPreflight ã§å¿é
ããããšãææ»ãã«ãªã£ãããã远ããšãã®ææã«ããã
|
|
1088
|
+
|
|
1089
|
+
- `updateTask` ããæžãçŽåã«èªã¿çŽããå€ãšä¿åããå€ïŒç¶æ
ã»æžã¿ãå®äºããæ»ããšæžã¿ãå€ããïŒãæ¯ã¹ãŠæ±ºããç¶æ
ãšåã1åã®æžã蟌ã¿ã«å
¥ããã
|
|
1090
|
+
`cause` 㯠`reopen`ïŒå®äºããæ»ããïŒã»`explicit`ïŒæžã¿ãå€ããšæç€ºããïŒã»`acceptance`ïŒåºæºã»èšŒæ ã»åºæºã®æ ¹æ ã®äžèº«ãå€ãã£ãŠæžã¿ãå€ããïŒã
|
|
1091
|
+
æžã¿ã®å®äºãæ»ãã1æäœã¯ `unchecked` ãš `reopened` ã®äž¡æ¹ãæã€1ä»¶
|
|
1092
|
+
- åãå€ã®åä¿åã»æžã¿ãä¿ã£ããŸãŸã®å€æŽã»ææç©ã®è¿œèšã§ã¯è¶³ããªããå±¥æŽã®å€ã¯ CLIã»API ããåãä»ããªããçŽæ¥ç·šéããã¯äœãããéå»ã®åã¯è£ããªã
|
|
1093
|
+
- å£ããå±¥æŽã¯ `reworkProblems` ãš `keepRaw` ã§å
ã®å€ãæ®ããæ°ããå±¥æŽã¯è¶³ããã« `reworkSkipped` ã§ç¥ãããïŒç¶æ
ã®å€æŽã¯æãŸãªãïŒ
|
|
1094
|
+
|
|
1095
|
+
**ä¿åã®ããã¯**: èŠæãšãã®ã¿ã¹ã¯ã®æŽæ°ã»äœæã»ã¢ãŒã«ã€ãã¯ãèŠæããšã®ããã¯ïŒ`requests/.locks/<èŠæID>.lock`ãèŠæã®ãã©ã«ãã®å€ãªã®ã§ã
|
|
1096
|
+
ã¢ãŒã«ã€ãã§äžç·ã«åããªãïŒã®äžã§ãèªã¿çŽããŠããæžãã»ç§»ããå¥ã®ããã»ã¹ã®ã¿ã¹ã¯ã®æŽæ°ãšãã¿ã¹ã¯ã»èŠæã®ã¢ãŒã«ã€ããéãªã£ãŠãã
|
|
1097
|
+
å
ã«ç§»ãããªãåŸã®æŽæ°ã¯ãç¡ããã«ãªããç§»ããåŸã®ãã¡ã€ã«ãæžãæ»ããªãïŒå
ã«æŽæ°ãããªãããã®å±¥æŽããšç§»ãïŒã
|
|
1098
|
+
ããã¯ã¯åããã·ã³ã®ããã»ã¹ã®éã ããç°åžžçµäºã§æ®ã£ãããã¯ã¯ 60 ç§ã§å€ããã®ãšããŠåãçŽãïŒ30 ç§åŸ
ã£ãŠãåããªããã°å€±æã«ããããçŽããïŒã
|
|
1099
|
+
ããã¯ã®é ã¯ã芪åã®æäœã®ããã¯ïŒ`.hierarchy.lock`ïŒâ èŠæã®ããã¯ãèŠæã®ããã¯ã®äžã§å¥ã®èŠæã»ã¿ã¹ã¯ã®ããã¯ã¯åããªã
|
|
1100
|
+
|
|
1101
|
+
### æ¯ãè¿ã
|
|
1102
|
+
|
|
1103
|
+
å€éšã®è©äŸ¡ãžã®å¯Ÿå¿: èç©ããèšé²ã§éçºãæ¯ãè¿ãäžäŸãšããŠãPreflight ã§å¿é
ãããªã¹ã¯ãå®è£
ã®åŸã«èµ·ãããã远ãïŒ`shared/retrospective.ts`ïŒã
|
|
1104
|
+
P3 㯠AI ã®å®è£
ãåããããæçžŸã枬ããªãã
|
|
1105
|
+
|
|
1106
|
+
- **èšé²**: èŠæã®ãã©ã«ãã® `retrospective.json`ïŒ`{version, targets: [...]}`ïŒãèŠæãšäžç·ã«ã¢ãŒã«ã€ãã»å
±æãããä¿åã¯èŠæã®ããã¯
|
|
1107
|
+
ïŒ`requestLock`ïŒã®äžã§èªã¿çŽã㊠`version` ãç
§ããïŒéãã° `retro_conflict`ïŒã1 äžããŠæžããããã¯ã®äžã§èŠæãç¡ããã°æžããªãïŒã¢ãŒã«ã€ãã®åŸã«äœãçŽããªãïŒã
|
|
1108
|
+
å£ããŠããã°ç©ºãšã¿ãªãã `retro_unreadable`
|
|
1109
|
+
- **åè£**ïŒ`retroCandidates`ïŒ: `status: completed` ã§è©äŸ¡ã®ãã run ã®ãã¡ã`materialization.done`ïŒ`created` ã®ã¿ã¹ã¯ãä»ããã»ã¢ãŒã«ã€ãæžã¿ã»ç¡ããç
§ããïŒã
|
|
1110
|
+
`adoption.done`ïŒ`reserved` ã®åã® `splitFrom` ã `<run>/<æ¡>` ã§èŠªããã®èŠæããç
§ããïŒã`materialization` ã®ç¡ã `materialized`ïŒæ§èšé²ïŒã
|
|
1111
|
+
éäžã®æ¡çšã¯åè£ã«ããªããèŠéãã®èŠæã¯åè£ãªãã䞊ã³ã¯ run ã®æ°ããé ã§ãå
é ã `latest`
|
|
1112
|
+
- **確å®**ïŒ`confirmTarget`ïŒ: åè£ã® run ã ãã`assessmentVersion`ïŒè©äŸ¡ã®å
容㮠hashïŒã»ãªã¹ã¯ã®äœçœ®ãšåæã»æ¡çšã®æ ¹æ ã»ç¢ºå®è
ãšæ¥æãåãã `V<n>` ã远èšããã
|
|
1113
|
+
2ä»¶ç®ããã¯èšæ£ã®çç±ïŒ`reason`ïŒãèŠããåã®å¯Ÿè±¡ã `replaces` ã«æ®ããåã run ãšåãè©äŸ¡ã®çã¯ç¢ºå®ãçŽããªããä»ã®å¯Ÿè±¡ã¯æåŸã®1ä»¶
|
|
1114
|
+
- 察象ã¯äººã®æç€ºã®æäœã§ã ãå€ããïŒPreflight ã®å®è¡ã»ã¿ã¹ã¯åã»åå²ã®æ¡çšã»ç»é¢ã® run ã®åãæ¿ãã§ã¯å€ããªãïŒãå
¥å£: CLI ã® `retro`ã
|
|
1115
|
+
API ã® `GET /api/requests/:rid/retrospective`ã»`POST .../retrospective/target`ã»`POST .../retrospective/judgments`
|
|
1116
|
+
- **ãªã¹ã¯ã®ç¢ºèª**ïŒ`addJudgment`ïŒ: `judgments` ã« `J<n>`ïŒå¯Ÿè±¡ IDã»ãªã¹ã¯ã®äœçœ®ã»åæã®åãã»ç¶æ
ã»äºå®ã»ç¯å²ã»æ ¹æ ã»çç±ã»æ¥æã»äž»äœïŒã远èšããã
|
|
1117
|
+
ãªã¹ã¯ã¯å¯Ÿè±¡ ID ãšäœçœ®ã§èŠåããïŒåæã®ãªã¹ã¯ãå¥ïŒãä»ã®ç¢ºèªã¯å¯Ÿè±¡ãšãªã¹ã¯ã®æåŸã®1ä»¶ã`occurred` ã¯äºå®ãšæ ¹æ ã`not_occurred` ã¯ç¯å²ãšæ ¹æ ãèŠãã
|
|
1118
|
+
`unchecked` ã¯æ ¹æ ãçµã³ä»ããã ããæ±ºãã確èªïŒ`unchecked` 以å€ïŒãå€ããã«ã¯çç±ãèŠããä»ã®å¯Ÿè±¡ã®ãªã¹ã¯ã ãã«è¶³ããä»¶æ°ïŒ`riskCounts`ïŒãä»ã®å¯Ÿè±¡ã ã
|
|
1119
|
+
- **æ ¹æ **ïŒ`core/retrospective.ts` ã® `resolveEvidence`ïŒ: ä¿åãããšãã«ä»ã®èšé²ãšç
§ãããåç
§å
ãšæç²ïŒ1000 æåãŸã§ïŒãšçµæã®çãåãã
|
|
1120
|
+
ã¿ã¹ã¯ã¬ãã¥ãŒã¯ãã®èŠæã®ã¿ã¹ã¯ïŒä»ã®ã»ã¢ãŒã«ã€ãïŒã®å®äºãã run ã® `overall`ã»`items`ã»`quality`ã»`unplanned`ã»`checks` ã®äœçœ®ã
|
|
1121
|
+
ãã€ã«ã¹ããŒã³ã¬ãã¥ãŒã¯åºå®ããææïŒ`input.requests`ïŒã«ãã®èŠæãçŽæ¥ãããã®ã ãã§ãæèŠã® `evidence` ã«èŠæ ID ã `<èŠæID>/TâŠ` ãç¡ããã°
|
|
1122
|
+
çµã³ä»ãçç±ãèŠãïŒå®è¡äžã®ææã®å€æŽ `inputChanged` ãåãïŒãææ»ãã¯ã¿ã¹ã¯ã® `reworkHistory` ã® IDã人ã®åç
§ã¯ç¢ºãããªã
|
|
1123
|
+
- **ç
§å**ïŒ`checkEvidence`ïŒ: èªããã³ã«ãä¿åããåç
§å
ã§ä»ã®èšé²ãåŒããçµæã®çãåããªã `ok`ãéãã° `changed`ãç¡ããã° `missing`ã
|
|
1124
|
+
èŠæã®ä»ãæ¿ãã»ã¿ã¹ã¯ã®ã¢ãŒã«ã€ãã®åŸããä¿åããèŠæ IDã»ã¿ã¹ã¯ ID ã§åŒãã芪åã®éã§ç¢ºèªãæ ¹æ ã¯ç¶æ¿ããªã
|
|
1125
|
+
|
|
1126
|
+
### éçºã®ææš
|
|
1127
|
+
|
|
1128
|
+
å€éšã®è©äŸ¡ãžã®å¯Ÿå¿: AI éçºã®ææãã³ãŒãã®éã§ã¯ãªããå°éã®æéã»åè³ªïŒææ»ãã»åºæºã®æªéïŒãªã©ã§æ¯ãè¿ãææãšããŠãèšé²ããææšãåºãã
|
|
1129
|
+
P3 㯠AI ã®å®è£
ãåãããŠæž¬ããªããæçžŸã®è©äŸ¡ã»é äœã«ã¯äœ¿ããªãã
|
|
1130
|
+
|
|
1131
|
+
- **å®çŸ©**: `core/metrics/definitions.ts` ã® `METRIC_DEFINITIONS` ã®1ãæãåå®çŸ©ã¯ IDã»ååã»åäœã»åºå
žã»å¯Ÿè±¡ã»ç®åºã»æ¬ æã®æ±ããš `compute(input)`ã
|
|
1132
|
+
CLI ã® `metrics`ã»API ã® `GET /api/metrics` 㯠`core/metrics/index.ts` ã® `metricsReport` ãéããåãå€ãè¿ã
|
|
1133
|
+
- **ç¯å²**: ãããžã§ã¯ãå
šäœïŒæå±ãªãã»ç»é²ã«ç¡ããã€ã«ã¹ããŒã³ã®èŠæãå«ãïŒãã`project.yaml` ã«ç»é²ãããã€ã«ã¹ããŒã³ã«ä»çŽæ¥å±ããèŠæã
|
|
1134
|
+
èŠéãã»ã¢ãŒã«ã€ãã®èŠæã¯é€ããã¿ã¹ã¯ã¯èŠæã®çŽäžã ããèªããªãèŠæã¯ `notices`
|
|
1135
|
+
- **å€ã®ç¶æ
**: `ok`ã»`no_targets`ïŒå¯Ÿè±¡ãªãïŒã»`no_data`ïŒæ¬ æã ãïŒã»`not_reached`ïŒãŸã å°éããŠããªãïŒã»`unrecorded`ïŒèšé²ãªãïŒãå€ã¯ `ok` ã®ãšãã ãã§ãã»ã㯠`null`ïŒ0 ã«ããªãïŒ
|
|
1136
|
+
- **å°éæé**: èŠæã® `createdAt` ãã `completionRecords` ã®æåã® `request_resolved`ã»`request_done` ãŸã§ã®äžå€®å€ãèšé²ã»æ¥æãèªããªãã»é転ã»
|
|
1137
|
+
ä»ã®ç¶æ
ããå°éæžã¿ãšåããã®ã«èšé²ãç¡ããã®ã¯æ¬ æãå®äºæžã®èšé²ã ãã§å¯Ÿå¿æžã®èšé²ãç¡ããã®ã¯çŽæ¥ã®é·ç§»ïŒå¯Ÿå¿æžã«æªå°éïŒã
|
|
1138
|
+
èšé²ã®1ã€ãç¡ãå®äºæžã¯ãå°éãããåãããªããïŒæ¬ æïŒã`updatedAt`ã»`doneAt` ã§æšãéããªã
|
|
1139
|
+
- **åãå
¥ãåºæº**: ä»å®äºããŠããã¿ã¹ã¯ã®ä»ã®åºæºã `acceptanceStatus` ã§ç
§ãããåæ¯ã¯æ°ããåºæºã®åèšãåºæºãªãã¯å¯Ÿè±¡ãªãã`acceptanceProblems` ãš
|
|
1140
|
+
èªããªãã¿ã¹ã¯ã®ãã¡ã€ã«ã¯æ¬ æã察å¿ããåºæºã®ç¡ã蚌æ ã¯åæ¯ã®å€
|
|
1141
|
+
- **ææ»ã**: ã¿ã¹ã¯ã® `reworkHistory` ã®ä»¶æ°ïŒåãã¿ã¹ã¯ã®åã `rev` ã¯1ä»¶ïŒã`reworkProblems` ãšèªããªãã¿ã¹ã¯ã®ãã¡ã€ã«ã¯æ¬ æãå±¥æŽã®ç¡ãã¿ã¹ã¯ã¯å
èš³ã®
|
|
1142
|
+
ãèšé²ãç¡ãããå±¥æŽããåã¯åãããªãïŒèŠ³æž¬ã®å§ãŸããä¿åããŠããªãã®ã§ãå
šæéã®å®å
šãã¯ä¿èšŒããªãïŒ
|
|
1143
|
+
- **ã¿ã¹ã¯ã¬ãã¥ãŒ**: ä»å®äºããŠããã¿ã¹ã¯ããšã«ã`selectTaskReview` ã§å®äºãã run ã1ä»¶éžã¶ïŒ`finishedAt` ã®æ°ããé ãåæå»ã¯ run ID ã®å€§ããæ¹ã
|
|
1144
|
+
èªããªãèšé²ã»`finishedAt` ã®ç¡ãå®äºã® run ãããã°æ¬ æïŒãéžãã çµæã® `items` ã® `missing` ãš `unplanned` ãå¥ã®ææšã«æ°ããã`undetermined`ã»`checks` ã¯
|
|
1145
|
+
å
èš³ã ããã¬ãã¥ãŒã®ç¡ãã¿ã¹ã¯ã°ãããªã `unrecorded`ãèªãã®ã¯ `taskReviews.list`ã»`get` ã ãã§ãrun ãäœããªãããã€ã«ã¹ããŒã³ã¬ãã¥ãŒã®æèŠã¯ä»åŸã®åè£
|
|
1146
|
+
- **人ãèšé²ããå€**ïŒ`kind: manual`ãå®çŸ©ã® `manual` ã«å€ã®èŠåïŒ: `core/metrics/manual.ts`ã`<data>/metrics/manual.json`ïŒ`{version: 1, seq, records}`ïŒã«æã¡ã
|
|
1147
|
+
`metrics/.manual.lock` ã®ããã¯ã®äžã§èªã¿çŽããŠãã眮ãæãã§æžããèå¥ã¯ææšã»ç¯å²ïŒ`project` ããã€ã«ã¹ããŒã³ IDïŒã»æéã»åäœã§ãåãå
å®¹ã¯æžããªãã
|
|
1148
|
+
å€ã»åºå
žã»ã¡ã¢ã®èšæ£ã¯èšé²ã® `rev` ãç
§ããïŒæž¡ããªãã»éãã° `metrics_conflict`ïŒãå£ãããã¡ã€ã«ã¯ç©ºãšã¿ãªãã `metrics_unreadable`ïŒèªãåŽã¯æ¬ æãš `notices`ïŒã
|
|
1149
|
+
衚瀺ã¯ç¯å²ãäžèŽããèšé²ã ããæéã»åäœããšã® `rows` ã«åºããç¯å²ã®éã»éè²šã»æéããŸããã§åç®ããªãïŒ`value` ã¯1è¡ã®ãšãã ãïŒãæžãã®ã¯ CLI ã ãã
|
|
1150
|
+
èšé²ã®ãããã€ã«ã¹ããŒã³ã¯ `checkMilestoneRemoval` ã§æ¶ãããç»é²ã«ç¡ããã€ã«ã¹ããŒã³ãžã®èšé²ã¯ `manual_orphan`
|
|
1151
|
+
|
|
1152
|
+
### å®äºã®èšé²
|
|
1153
|
+
|
|
1154
|
+
ã¿ã¹ã¯ã®å®äºïŒ`task_done`ïŒã»äººã®æžã¿ïŒ`task_checked`ïŒã»èŠæã®å¯Ÿå¿æžïŒ`request_resolved`ïŒã»å®äºæžïŒ`request_done`ïŒã®ãšãã
|
|
1155
|
+
ãã®ãšãã®æ¡ä»¶ã®åãã `completionRecords` ã«è¿œèšããïŒ`shared/completionRecord.ts`ïŒãä»ã®å€ïŒ`doneAt`ã»`checkedAt` ã¯åéã§æ¶ããïŒãšã¯å¥ã«æã¡ã
|
|
1156
|
+
åŸãããåœæã©ã®æ¡ä»¶ã§å®äºã»ç¢ºèªãããããæ¯ã¹ãææã«ããã
|
|
1157
|
+
|
|
1158
|
+
- ç¶æ
ãšåãæŽæ°ïŒåã revïŒã§åããã¡ã€ã«ã«æžããçæ¹ã ããä¿åãããããšã¯ãªãã`expectedRev` ã®ç«¶åã§ã¯äœãæžããªã
|
|
1159
|
+
- 奿©ã¯æžãçŽåã«èªã¿çŽããå€ãšæžããåŸã®å€ããæ±ºããïŒ`taskTriggers`ã»`requestTriggers`ïŒãã¿ã¹ã¯ã¯å®äºã§ãªããã®ãå®äºã«ãªã£ãã
|
|
1160
|
+
`task_done`ãå®äºã§æžã¿ãä»ããã `task_checked`ïŒæžã¿ã®ãŸãŸåºæºã»èšŒæ ã»åºæºã®æ ¹æ ãå€ããŠæžã¿ãä»ãçŽãããšããè¶³ãïŒã
|
|
1161
|
+
åãç¶æ
ã®åä¿åã»ææç©ã®è¿œèšã»æžã¿ã®ä»ãçŽãã§ã¯è¶³ããªããåéã»æžã¿ã®è§£é€ã§ãæ¶ããªã
|
|
1162
|
+
- åãå€ã¯ãåãæäœã§å€ããåºæºã»èšŒæ ãåœãŠãåŸã®ãã®ãå質ã¯å®äºãããšãã®ææ°ã®å€ïŒèšå®å
šäœã®çã»äœæ¥å
ã«åœãŠã¯ãŸãé
ç®ãšé€å€ïŒã§ã
|
|
1163
|
+
åã蟌ãã ãšãã®çã¯åºæºã® `quality.version` ã«æ®ããèŠæã®èšé²ã¯é¡ãš `requestSubject`ïŒé¡ãšæ¬æã® hashïŒãæã¡ãæ¬æã¯åããªã
|
|
1164
|
+
- èŠæã®èšé²ã® `tasks`ã»`children` ã¯å€å®ã«äœ¿ã£ãçŽäžã®ã¿ã¹ã¯ãšåã®èŠæïŒIDã»revã»ç¶æ
ã»ãã®æç¹ã®ææ°ã®èšé² IDïŒãåã ãã®èŠªãåã®èšé²ãã蟿ãã
|
|
1165
|
+
- åç
§å
ã¯æžãåïŒããã¯ã®å€ïŒã« `core/completionRefs.ts` ãåã: `git rev-parse HEAD` ãšãåç
§å
ã®ãã©ã«ãã«éã£ã `git status --porcelain`ã
|
|
1166
|
+
ç¶æ
㯠`ok`ã»`not_git`ã»`unregistered`ã»`missing`ã»`notdir`ã»`failed` ã§ãçç±ã«ã¯ãã®ãã·ã³ã®ãã¹ãå
¥ããªããå®äºã«ãªãããæŽæ°
|
|
1167
|
+
ïŒç¶æ
ãå®äºã«ããã»æžã¿ãä»ããã»å¯Ÿå¿æžã»å®äºæžã«ããïŒã®ãšãã ãåããPreflight ã®è©äŸ¡å¯Ÿè±¡ã«ã¯ã³ãããã®åºå®ãç¡ãã®ã§ãrun ããè£ããªã
|
|
1168
|
+
- å
¥å£: `createTask`ïŒå®äºã§äœãïŒã»`updateTask`ïŒCLI ã® moveã»setã»checkãAPI ã® PATCHãå質ã®åã蟌ã¿ïŒã»`updateRequest`ïŒCLI ã® request setã
|
|
1169
|
+
API ã® PATCHããã€ã«ã¹ããŒã³ã®äžæ¬å®äºïŒãã©ããèšé²ã®å€ãåãä»ããïŒ`completionRecords` ã¯æšãŠãïŒãP3 ãäœã
|
|
1170
|
+
- èšé²ã®ç¡ãå€ãããŒã¿ã¯è£ããªããèªããªãèšé²ã¯ `completionProblems` ã«ã㊠`keepRaw` ã§å
ã®å€ãæžãæ»ããæ°ããèšé²ã¯è¶³ããªã
|
|
1171
|
+
ïŒç¶æ
ã¯å€ãã`completionSkipped` ã§ç¥ãããïŒãèªããªãå質ã»åºæºã»æ ¹æ 㯠`problems` ãšããŠåããå®äºã¯æãŸãªã
|
|
1172
|
+
- ãã¡ã€ã«ã®äžŠã³ã§ã¯æåŸïŒ`updatedBy` ã®åŸïŒã«æžãã人ãèªãé
ç®ãäžã«æ®ããã
|
|
1173
|
+
- äžèЧïŒé²æã»ã¿ã¹ã¯ã®äžèЧïŒã«ãä»ã¯å
šéšãèŒãïŒèŠæã»ã¿ã¹ã¯ã®å€ããã®ãŸãŸè¿ãããïŒã鲿ã®ã¿ã¹ã¯ã®å°ã¯èšé²ãèŒãããèŠçŽãã®ç¶æ
ã ããæã€
|
|
1174
|
+
|
|
1175
|
+
### èŠçŽãåè£
|
|
1176
|
+
|
|
1177
|
+
å€éšã®è©äŸ¡ïŒèª²é¡ CïŒãžã®å¯Ÿå¿: éå»ã«æ£ãããšå€æãããã®ãã仿§ãç°å¢ã®å€åã§æ£ãããªããªãããšãããã倿ãééããšæ±ºãã€ããã
|
|
1178
|
+
åœæã®æ¡ä»¶ïŒå®äºã®èšé²ïŒãšä»ã®æ¡ä»¶ã®å·®ããèŠçŽããå¿
èŠïŒåè£ïŒããšããŠç€ºãïŒ`shared/reviewCandidate.ts`ïŒãç¶æ
ã¯å¢ãããªãã
|
|
1179
|
+
|
|
1180
|
+
- **åºç¹**: ã¿ã¹ã¯ã»èŠæã®ææ°ã®å®äºã®èšé²ã人ãããäžåºŠæžã¿ã»å®äºã«ããã°æ°ããèšé²ãåºç¹ã«ãªããèšé²ãç¡ãã»èªããªããšãã¯
|
|
1181
|
+
`no_record`ã»`unreadable` ã§ãå·®åãªãïŒ`none`ïŒãšãåè£ïŒ`candidate`ïŒãšãåãã
|
|
1182
|
+
- **察象**: å®äºããã¿ã¹ã¯ïŒæžã¿ã®æç¡ãåããªãïŒãšãå¯Ÿå¿æžã»å®äºæžã®èŠæèªèº«ãèŠæã®è©³çްã»é²æã«ã¯é
äžã®åè£ã®ä»¶æ°ïŒ`tasks`ã»`below`ïŒã
|
|
1183
|
+
æ·»ãããã芪èªèº«ãåè£ã«ã¯ããªãã`below` ã¯åå«ã®èŠæèªèº«ãšãã®ã¿ã¹ã¯ã1åãã€æ°ãããã¢ãŒã«ã€ãã¯èŠãªã
|
|
1184
|
+
- **å質**: `standardsFor` ã§äœæ¥å
ã«åœãŠã¯ãŸãé
ç®ãåœæïŒèšé²ã® `quality.standards`ïŒãšä»ã§æ¯ã¹ãïŒ`quality_added`ã»`quality_changed`
|
|
1185
|
+
ïŒ`standardHash`ïŒã»`quality_removed`ã»`quality_exempted`ïŒãèšå®å
šäœã®çïŒ`qualityVersion`ïŒã®éãã ãã§ã¯åè£ã«ããªãã
|
|
1186
|
+
ä»ãæªèšå®ã»èªããªããªã `quality_state`ãåœæãèªããªããªãæ¯ã¹ãªããèŠæã®èšé²ã¯é
ç®ãåããªãã®ã§ç¶æ
ã ããæ¯ã¹ã
|
|
1187
|
+
- **åºæºãšæ ¹æ **: åºæºã¯ ID ã§æ¯ã¹ãïŒ`criterion_added`ã»`criterion_changed`ã»`criterion_removed`ïŒãåºæºããšã®æ ¹æ 㯠(åºæº ID, èšé² ID)ã
|
|
1188
|
+
åºæºãåããèŠæã®æ ¹æ ïŒ`from`ïŒã¯åœæã®å
ãšä»ã®å
ãæ¯ã¹ãïŒ`source_changed`ã»`source_removed`ã»`source_unconfirmed`ïŒãèŠæèªèº«ã¯èŠæã®æ ¹æ ã®å
šéš
|
|
1189
|
+
- **åæã®å€æŽ**: èŠæã® `premiseChanges`ïŒ`[{id: P1, targets, reason, condition, at, by, acks?}]`ã远èšã ãïŒã察象ã¯èŠæ IDã»ãã®èŠæã®
|
|
1190
|
+
ã¿ã¹ã¯ IDã»èŠæã®æ ¹æ ã® ID ã§ãèšé²ãããšãã«æããã®ã ããåºç¹ããåŸã®å€æŽã§ã察象ã«å€æŽããåŸã®ç¢ºèªïŒ`acks`ïŒãç¡ããã®ã `premise_changed`
|
|
1191
|
+
ã«ãããã¿ã¹ã¯ã¯ã¿ã¹ã¯ ID ãšãåºæºãåããèŠæã®æ ¹æ ã® ID ã®å€æŽãèŠããèŠæèªèº«ã¯èŠæ ID ãšèŠæã®æ ¹æ ã® IDãæ¢åã® `source` æäœã§è¡šãã
|
|
1192
|
+
æ ¹æ ã®å€æŽã¯ãæ ¹æ ã®å·®ãšããŠèªåã§åºãïŒåæã®å€æŽã¯å€éšã®å€åã衚ããšãã«äœ¿ãïŒ
|
|
1193
|
+
- çç±ã¯åãçš®é¡ãšå¯Ÿè±¡ã§1ä»¶ã«ãããåçç±ã¯åœæïŒ`was`ïŒã»ä»ïŒ`now`ïŒã®çãå€ãšé¢ä¿ãã察象ïŒ`related`ïŒãæã€ã`then` 㯠Promise ãš
|
|
1194
|
+
åãéããããã®ã§äœ¿ããªã
|
|
1195
|
+
- 蚺æã¯èªã¿èŸŒãã å€ã ãã§è¡ãããã¡ã€ã«ãæžãã git ãå®è¡ããªãïŒåç
§å
ã®ã³ãããã¯æ¯ã¹ãªãïŒãå
¥å£: CLI ã® `revisit`ã»`ls --review`ã»`show`ã»
|
|
1196
|
+
`progress`ãAPI ã® `GET /api/revisit`ã»`?review=true`ã»èŠæãšã¿ã¹ã¯ã®è©³çŽ°ã® `review`ã»é²æã® `review`
|
|
1197
|
+
- 蚌æ ã®ãå確èªãå¿
èŠãïŒ`stale`ïŒã»åºæºã蚌æ ã®æç€ºã®ç·šéã«ããæžã¿ã®è§£é€ãšã¯å¥ã®æå³ãšããŠæ®ã
|
|
1198
|
+
|
|
976
1199
|
### åãå
¥ãåºæºãšèšŒæ
|
|
977
1200
|
|
|
978
1201
|
ã¿ã¹ã¯ã¯ä»»æã§ **åãå
¥ãåºæº**ïŒ`acceptanceCriteria: [{id, text}]`ãäœãæºããã°å®äºãïŒãæã¡ãäœæ¥ããåŽã¯åºæºããšã«
|
|
@@ -984,13 +1207,24 @@ API ã® PATCHã`rev` ã§æ¥œèгããã¯ïŒãæžãæããŠãç¶æ
ã»æ¢å
|
|
|
984
1207
|
`acceptanceSeq` ã«æ®ãïŒãåºæºã»èšŒæ ã¯æäœã§ã ãå€ããPATCH ã® `acceptanceCriteria` ãªã©ããã®ãŸãŸæžãéã¯æããªã
|
|
985
1208
|
- **蚌æ ã¯ç³å**: çµæã¯ `met` / `unmet` / `unverified`ã`met` ã¯æ¬æãèŠãïŒç©ºã¯å
¥åã®èª€ãïŒãæªèšé²ïŒèšŒæ ãªãïŒãšæªæ€èšŒã¯åããã
|
|
986
1209
|
ããã¯äœæ¥ããåŽã®ç³åã§ãã¬ãã¥ãŒã®å€å®ã§ã¯ãªãïŒAI ã®ã¬ãã¥ãŒãè¶³ããšããããã®å€å®ã¯èšŒæ ãšã¯å¥ã®åã§æã¡ã蚌æ ãæžãæããªãïŒ
|
|
1210
|
+
- **æ ¹æ ã®çš®é¡**: 蚌æ ã¯ä»»æã® `basis` ãæã€ïŒ`{kind: unverified}` æªç¢ºèª / `{kind: declaration}` ç³åã®ã¿ / `{kind: read, reference}`
|
|
1211
|
+
èªãã§ç¢ºèª / `{kind: machine, command, result, target}` æ€æ»çµæããïŒãçµæãšå¥ã®è»žã§ãã©ããäœæ¥ããåŽã®ç³åïŒP3 ã¯å®è¡ããªãã
|
|
1212
|
+
read ãš machine ã«æ£ããã®äžäžã¯ä»ããªããäººã®æžã¿ã¯ã¿ã¹ã¯ã® `checkedAt` ã§ãbasis ã« human ã¯äœããªããAI ã¬ãã¥ãŒã®å€å®ã¯åããªãïŒã
|
|
1213
|
+
åã»ã©ãã«ã»çµã¿åããïŒmet / unmet ã«æªç¢ºèªã¯äžå¯ãunverified ã¯æªç¢ºèªã ãïŒã»å€ãå€ã®è§£éã»å
èš³ã»å€æŽã®æ¯èŒã¯ `shared/acceptance.ts`ã
|
|
1214
|
+
æ ¹æ ãçãã record ã¯ãåãçµæã®åã®èšŒæ ã®æ ¹æ ãåŒãç¶ããç¡ããã° unverified ã¯æªç¢ºèªã»ã»ãã¯ç³åã®ã¿ïŒå€ã CLIã»ç»é¢ã®æŽæ°ã
|
|
1215
|
+
劚ãããå€ã蚌æ ãåãå€ã§ä¿åãçŽããŠãæ ¹æ ãè¶³ããªãïŒãä¿åããå€ã« basis ãç¡ãå€ã蚌æ ã¯æžãæãããèªããšãã ã
|
|
1216
|
+
unverified ã¯æªç¢ºèªãã»ãã¯ãç³åã®ã¿ïŒçš®é¡æªèšé²ïŒããšè§£éããïŒæ¬æããæšãéã£ãŠæ ŒäžãããªãïŒã`acceptanceStatus` ã® `met` ã¯
|
|
1217
|
+
ãæºããããšç³åããæ°ãã®ãŸãŸã§ãæå¹ãª met ã®æ ¹æ ããšã®ä»¶æ° `metByBasis` ãšç³åã®ã¿ã®åºæº `declarationOnly` ãè¶³ãïŒstaleã»orphan ã¯
|
|
1218
|
+
å
¥ããªãïŒãç³åã®ã¿ã® met 㯠shortfalls ã«æ³šæãšããŠåºãããå®äºã»æžã¿ã¯æãŸãªããé²æã® `TaskMark.evidence` 㯠`evidenceSummary`
|
|
1219
|
+
ã®å°ããªæŠèŠïŒä»¶æ°ãšèªããªãå€ã®æç¡ãæ¬æã»ã³ãã³ãã¯èŒããªãïŒãCLI 㯠`evidence` ã® `--basis` ãšé
ç®ããŸãšããŠã¯ `--evidence-json`
|
|
1220
|
+
ïŒMarkdown ã® `--evidence-file` ãšåæã«ã¯äœ¿ããªãïŒ
|
|
987
1221
|
- **倱å¹ãšæ¶ããåºæº**: 蚌æ ã¯èšé²ãããšãã®åºæºã®æèšãåããŠæã€ãæèšãå€ããåºæºã®èšŒæ ã¯ãå確èªãå¿
èŠããšããŠéæã«æ°ããªãã
|
|
988
1222
|
åºæºãæ¶ããŠã蚌æ ã¯ã察å¿ããåºæºã®ãªã蚌æ ããšããŠæ®ããåèšé²ã¯ãã® ID ã®èšŒæ ã眮ãæããïŒåãå€ãªãèšé²ã®æ¥æãå€ããªãïŒã
|
|
989
1223
|
å±¥æŽã¯æããªã
|
|
990
1224
|
- **å®äºãæãŸãªã**: åºæºãªãã»èšŒæ ãªãã»æªéã»æªæ€èšŒã§ããå®äºã»æžã¿ã»å¯Ÿå¿æžã¯ä»ãŸã§ã©ããïŒç¶æ
ãèŠæã®å€å®ãå¢ãããªãïŒã
|
|
991
1225
|
äžè¶³ã¯ `acceptance.shortfalls`ïŒshowã»API ã® GETïŒãš `move ... done` ã® stderr ã§èªããããã«ããã ããAI ã®å®äºã«å€æŽã®èšé²ãèŠã
|
|
992
1226
|
CLI ã®æ±ºãŸãã¯å€ãããAPI ã«ã¯åºããªã
|
|
993
|
-
- **æžã¿ã®è§£é€**:
|
|
1227
|
+
- **æžã¿ã®è§£é€**: æžã¿ã®ã¿ã¹ã¯ã®åºæºã»èšŒæ ã®äžèº«ïŒäžŠã³ã»æèšã»çµæã»èšŒæ ã»æ ¹æ ïŒãå€ãã£ããæžã¿ãå€ãã`checkCleared` ã«çç±ãè¿ãã
|
|
994
1228
|
åãå€ã®åä¿åã»ææç©ã®è¿œå ã»åãæäœã§æžã¿ãä»ãçŽããšãã¯å€ããªããæªå®äºãžæ»ããšå€ããã®ã¯ä»ãŸã§ã©ãã
|
|
995
1229
|
- **ä»ã®å€ã«åœãŠã**: æäœã¯æžãçŽåã«èªã¿çŽãããã¡ã€ã«ã®å€ã«åœãŠã1ã€ã§ãèŠåã«åããªããã°äœãæžããªãïŒ`rev` ãæž¡ãã°ç«¶åãåããïŒ
|
|
996
1230
|
- **Preflight ã®ã¿ã¹ã¯æ¡**: æ¡ïŒ`drafts/D*.md`ïŒã `acceptanceCriteria` ãæã€ãCodexã»æå
ã®ãšãŒãžã§ã³ãã¯æã®äžŠã³ã§æžãã
|
|
@@ -1306,7 +1540,7 @@ Playwright ãå
¥ã£ãŠããããã ãã§ã¯æç»ã®å®å
šã®æ¡ä»¶ïŒãã
|
|
|
1306
1540
|
- åçš¿ã¯æãåã«ç¢ºãããïŒ`render.ts` ã® `checkHtml`ïŒ: 䜿ããã®ã¯ `<style>` ã® CSSã»`data:` ã®ç»åãšãã©ã³ãã»ããŒãžã®äžã® `#id`ã
|
|
1307
1541
|
ã¹ã¯ãªããã»`on*` 屿§ã»`javascript:`ã»å€ã®ãã¡ã€ã«ãéä¿¡ãæãåç
§ïŒ`http(s):`ã»`file:`ã»çžå¯Ÿãã¹ã»`@import`ïŒã»
|
|
1308
1542
|
`iframe` / `object` / `embed` / `link` / `base` / `meta http-equiv` ã¯æããå¹
㯠320ã2560 pxãå皿㯠2MB ãŸã§ãé«ã 16384 px ãè¶
ãã
|
|
1309
|
-
ãšããã¯åããDevContainer
|
|
1543
|
+
ãšããã¯åããDevContainer ã®äžããã¯ãåºåå
ã®äžæã®ãã©ã«ãããã¹ãã®ãã©ã«ãïŒbindïŒã®äžã«ããå¿
èŠãããïŒãã¹ã¯èªåã§æ±ºãããããŠã³ããããã¹ã®æ±ºãæ¹ïŒ
|
|
1310
1544
|
- æ¥æ¬èªã®ãã©ã³ã㯠Debian ã® `fonts-noto-cjk`ïŒSIL Open Font License 1.1ïŒãã€ã¡ãŒãžã®äžã«ã ãå
¥ããP3 ã®é
åžç©ã«ã¯å«ããªã
|
|
1311
1545
|
- Playwright ã®äŸåïŒ`--with-deps`ïŒã§ WenQuanYi Zen HeiïŒäžåœèªã®å圢ïŒãå
¥ããfontconfig ã§ã¯ãããç·ç§°ã®æ¢å®ã«å
ã«æ¥ãã
|
|
1312
1546
|
`fonts-ja.conf`ïŒ`/etc/fonts/conf.d/99-p3-ja.conf` ã«çœ®ãïŒã§ãç·ç§°ïŒ`sans-serif`ã»`system-ui`ã»`serif`ã»`monospace`ïŒãšã
|
|
@@ -1370,41 +1604,71 @@ Playwright ãå
¥ã£ãŠããããã ãã§ã¯æç»ã®å®å
šã®æ¡ä»¶ïŒãã
|
|
|
1370
1604
|
ãã¡ã€ã«å
容ã®ããã·ã¥ã«ããæ¥œèгããã¯ã«å€ããã°ã`rev` ããã¡ã€ã«ã«æžããã«æžããèŠæåäœã§äººãæä»ããã®ã§åªå
床ã¯äœãïŒä»åŸïŒ
|
|
1371
1605
|
3. **git ã䜿ããªãã¡ã³ããŒã** é²èЧã ããªããéç㪠HTML ã«æžãåºããŠå
±æããïŒ`p3 export`ãä»åŸïŒ
|
|
1372
1606
|
|
|
1373
|
-
## AI ãšãŒãžã§ã³ããžã®æç€ºïŒ`p3 init --agents` / `p3 agents`
|
|
1374
|
-
|
|
1375
|
-
|
|
1376
|
-
|
|
1377
|
-
|
|
1378
|
-
|
|
1379
|
-
`
|
|
1380
|
-
|
|
1381
|
-
|
|
1382
|
-
`p3
|
|
1383
|
-
|
|
1607
|
+
## AI ãšãŒãžã§ã³ããžã®æç€ºïŒ`p3 init --agents` / `p3 agents` ã§çœ®ãå
¥å£ïŒ
|
|
1608
|
+
|
|
1609
|
+
åãããžã§ã¯ãã«çœ®ãã®ã¯ **å
¥å£** ã ãã«ããæé ã®æ¬æã¯å®è¡äžã® CLI ããèªãŸããïŒ`p3 guide`ïŒã眮ãããã¡ã€ã«ã¯äººãæŽæ°ããªããš
|
|
1610
|
+
å€ããŸãŸæ®ãïŒåæ¬ãå€ããŠãå±ããªãïŒããCLI 㯠`pnpx @infodb/p3` ã§æ°ãããã®ã䜿ãããã®ã§ãæé 㯠CLI ã®çã«åã£ããã®ã«ãªãã
|
|
1611
|
+
|
|
1612
|
+
- å
¥å£ã¯2ã€ã忢±ã®ã¹ãã«ïŒåæ¬ã¯ `skills/p3/SKILL.md` ã®1ã€ãéžãã å
ïŒ`claude` 㯠`.claude/skills/p3/SKILL.md`ïŒClaude CodeïŒã
|
|
1613
|
+
`codex` 㯠`.agents/skills/p3/SKILL.md`ïŒCodexïŒïŒã«åããã®ãåãã眮ãå
ã®äžèŠ§ã¯ `src/cli/project.ts` ã® `AGENT_TARGETS`ã
|
|
1614
|
+
éžã³æ¹ã¯ `AGENT_CHOICES`ãå人ã®ã¹ãã«ã®å Žæã«ã¯çœ®ããªãïŒãšãAGENTS.mdïŒç¡ããã° CLAUDE.mdïŒã®ãã¿ã¹ã¯ç®¡çïŒinfodb p3ïŒãã®ç¯
|
|
1615
|
+
ïŒ`src/cli/project.ts` ã® `agentsSnippet`ãã¹ãã«ã®åç
§ã¯ãéžãã å
ãšæ¢ã«ããå
ã ããæžããäžã¯äž¡æ¹ã®ãšãã® `AGENTS_SNIPPET`ïŒ
|
|
1616
|
+
- å
¥å£ã«æžãã®ã¯ããã€äœ¿ããïŒã¹ãã«ã® `description`ïŒã»`pnpx @infodb/p3 guide --json` ã® `guide` ãæåŸãŸã§èªãã§åŸãããšã»ååŸ
|
|
1617
|
+
ã§ããªããã° p3 ãæäœãããšã©ãŒãšåŒã³æ¹ã人ã«äŒããŠçµããããšã ããå
¥å£ã®å€ãã®äŒãæ¹ã»`whoami` ã§ã®å¯Ÿè±¡ã®ç¢ºããæ¹ã»æŽæ°ã®
|
|
1618
|
+
ãããã¯æé ïŒguideïŒã®åŽã«æžã
|
|
1619
|
+
- å
¥å£ã®çïŒ`ENTRY_VERSION`ã`src/cli/guide.ts`ãæ£ã®æŽæ°ïŒããã¹ãã«ã¯ frontmatter ã® `metadata.p3-entry-version`ïŒAgent Skills ã®
|
|
1620
|
+
`metadata` ã¯æååã®å¯Ÿå¿ãªã®ã§ `"1"`ïŒãç¯ã¯èŠåºãã®æ¬¡ã®è¡ã®ã³ã¡ã³ã `<!-- p3-entry-version: 1 -->` ã«æããããå
¥å£ã«æžãããš
|
|
1621
|
+
ïŒåŒã³æ¹ã»èªã¿èŸŒã¿ã®çŽæïŒãå€ãããšãã ãäžããæé ã®æ¬æã®æ¹èšã§ã¯äžããªããJSON ã® `schemaVersion`ã»CLI ã® `cliVersion` ãšã¯å¥
|
|
1622
|
+
- 眮ãå
ãèŠããŠããå
±æã®èšå®ã¯æããªãïŒåå ã® `join` ã¯çœ®ããã眮ãã»ææ°ã«ããã®ã¯äººãæç€ºãã `p3 agents` ã ããªã®ã§ãæ¶ããå
ã
|
|
1623
|
+
æ»ããªãïŒãæ¢ã«ããã¹ãã«ã»ç¯ã¯äžæžãããã`--force` ã§éžãã å
ã®ã¹ãã«ãš p3 ã®ç¯ã ãã忢±ã®çã«ããïŒç¯ã®ååŸã®æã¯æ®ãã
|
|
1624
|
+
ç¯ãè€æ°ã»èŠåºãã«ãªã£ãŠããªããã°å€ããã«æã§æŽçããŠãããïŒãæžãå
ã¯ã¡ã€ã³ã®äœæ¥ããªãŒïŒ`repoRoot`ïŒ
|
|
1625
|
+
- æ€æ»ïŒ`test/agents.test.ts`ïŒ: å
¥å£ã¯çã»ååŸã®æç€ºã»æ¢ãŸãæ¹ãæã¡ãæé ã®æ¬æãåããŠããªãïŒçãïŒããšãæé ã®æ±ºãŸãïŒåœ¹å²ã»
|
|
1626
|
+
çµããæ¹ïŒã¯ guide ã®åæ¬ã«æãããäžã®åã㯠`AGENTS_SNIPPET` ãšåã
|
|
1384
1627
|
|
|
1385
1628
|
```markdown
|
|
1386
1629
|
## ã¿ã¹ã¯ç®¡çïŒinfodb p3ïŒ
|
|
1387
1630
|
|
|
1388
|
-
|
|
1389
|
-
|
|
1390
|
-
-
|
|
1391
|
-
-
|
|
1392
|
-
-
|
|
1393
|
-
- ãããžã§ã¯ããç¡ãã»æªç»é²ã®ãšã㯠`p3 init` / `p3 join` ãèªåããå®è¡ãããæ°ããäœãïŒ`init`ïŒã®ãå
±æããããã®ã«åå ããïŒ`join`ïŒã®ãã人ã«ç¢ºããã
|
|
1394
|
-
- æ°ããäœæ¥ãé ŒãŸããã `p3 request new "<ã¿ã€ãã«>" --body "..."` ã§èŠæãç»é²ããID ãäŒããŠçµããã
|
|
1395
|
-
PreflightïŒ`preflight`ïŒã¯èªåããå§ããªãïŒå§ããªãã»å°ããªãïŒãã¿ã¹ã¯åïŒ`accept`ïŒã¯äººãè¡ãïŒçµæã `p3 drafts` ã§èªãã®ãšãé ŒãŸããã¡ã¢ã®ä¿å `--note-only` ã¯ããïŒ
|
|
1396
|
-
- Preflight ãé ŒãŸããããæ
åœïŒ`whoami --json` ã® `preflight.runner`ïŒã§åããã`codex`: 人ã `p3 preflight` ãç»é¢ã§å®è¡ããïŒAI 㯠`--prepare` ã®ç¡ã `p3 preflight` ãããªãïŒã人ããã£ããã§å¯Ÿè±¡ã®èŠæã®æå
ã®è©äŸ¡ãæç€ºçã«é Œãã ãšãã ãæå
ã§è©äŸ¡ãããPreflight ããŠããšã ããªãã人ãå®è¡ããã®ãæå
ã§è©äŸ¡ããã®ãã確ãããã`agent`: 人ã«ãPreflight ããŠããšé ŒãŸãããæå
ã§è©äŸ¡ããïŒããã®ãã£ããã§ãã¯æ±ããªãïŒã`null`ïŒèªããªãïŒ: `agent` ãšæšæž¬ãã `problem` ãäŒãã`codex` ãšåãæ±ããåã®èŠæãåãã察象ã®èŠæãåãããªããã°ç¢ºããã
|
|
1397
|
-
- æå
ã®è©äŸ¡: `p3 preflight <èŠæID> --prepare --json` â è¿ã£ãæç€ºã®ãã¡ã€ã«ïŒ`instructions`ïŒãæåŸãŸã§èªã¿ãæžãã®ã¯è¿ã£ã run ã®ææç©ïŒ`outputs`ïŒã ã â `p3 preflight <èŠæID> --complete --run <run> --json` â `p3 drafts` ã®çµæãäŒããŠçµããïŒèªåããå§ããªããã¿ã¹ã¯å `accept` ãšçæã¯ããªãïŒ
|
|
1398
|
-
- çæããåã« `p3 show T003 --brief --json` ã§æ¬æã»äŸåãšãã®ç¶æ
ïŒ`dependencies`ïŒã»çœ®ãæãã®æ³šæïŒ`warnings`ïŒãèªã
|
|
1399
|
-
- çæããåã«ã`--brief --json` ã® `work`ïŒäœæ¥å
ã®ãªããžããªãšãã©ã³ãïŒãèŠãŠããã®ãªããžããªã§ãã©ã³ãã«å
¥ãïŒäœæ¥å
ãªããªãç§»åããªãïŒ
|
|
1400
|
-
- çæãããšã㯠`p3 move T003 doing`ããã¹ããéããããã³ãããããåã« `p3 move T003 done --output <ä»ããææç©ïŒå€ãããã¡ã€ã«ã説æïŒ> --record -` ã§å®äºã«ããïŒå€æŽã®èšé²ã¯å¿
é : äœãå€ãããã»ãªãã»å
¥ããæ±ºãŸãã»ããããã® ãæšæºå
¥åãã Markdown ã§ããŸã ç¡ã URL ã¯æžããªãïŒ
|
|
1401
|
-
- åãå
¥ãåºæºïŒ`--brief --json` ã® `item.acceptanceCriteria`ïŒãããã°çæããåã«èªã¿ãå®äºãããšãã«åºæºããšã®èšŒæ ã `--evidence-file evidence.md`ïŒèŠåºã `## A1 met` ããšã«éãããã¹ãã»ã³ãã³ããšçµæã»ç¢ºãããããšïŒã§æ®ãã`[Q1]` ã§å§ãŸãåºæºã¯ãããžã§ã¯ãã®åè³ªåºæºã§ããã®æ€æ»ã¯èªåã§å®è¡ããŠã³ãã³ãã»åç
§å
ãšã³ãããïŒæªã³ããããªãããæžãïŒã»çµæã»ç¯å²ã蚌æ ã«æžãïŒP3 ãå®è¡ãããšã¯æžããªãïŒãæºãããªãã£ãã»ç¢ºãããŠããªãé
ç®ã¯ `unmet` / `unverified` ãšçç±ãæ£çŽã«æžãïŒæšæž¬ã§ `met` ã«ããªãïŒãæªéã»æªæ€èšŒãæ®ããŠå®äºã«ããã人ã«äŒããã蚌æ ã¯èªåã®ç³åã§ãæžã¿ã«ãããã¯äººã決ãããåºæºãèªåã§æ¶ãã»æžãæããŠæºãããããšã«ããªã
|
|
1402
|
-
- èŠæã®ã¿ã¹ã¯ãå
šéšçµããããã³ãããããåã« `p3 request set <èŠæID> status=resolved`ïŒå¯Ÿå¿æžïŒã«ãããå®äºæžïŒdoneïŒã»èŠéãïŒrejectedïŒãšã¿ã¹ã¯ã®æžã¿ïŒcheckïŒã¯äººã決ãã
|
|
1403
|
-
- åã®èŠæïŒ`parent` ã®ããèŠæïŒã¯ã芪ãšã¯å¥ã®èŠæãšããŠåããšã®ã¿ã¹ã¯ãšãã©ã³ãã§äœæ¥ããïŒèŠªã®ã¿ã¹ã¯ã«ããªãïŒãåå²ã®æ¡ã®æ¡çšïŒ`accept`ïŒã¯äººãè¡ããåã® Preflight ã¯èŠªãšåãæ
åœã§ãé ŒãŸãããšãã ãïŒåå²ã®æ¡çšã»åã®äœæããèªåã§è©äŸ¡ãžé²ãŸãªãïŒã芪ãå¯Ÿå¿æžã«ããã®ã¯ã芪ã®ã¿ã¹ã¯ãšèŠéã以å€ã®åïŒ`request show <芪> --brief --json` ã® `children`ïŒãå
šéšçµãã£ãŠãã
|
|
1404
|
-
- ããŒã¿ã®ãã©ã«ãããã®äœæ¥ããªãŒã®äžã§ git 管çãããŠãããªããèŠæã®ãã©ã«ãïŒ`requests/<èŠæID>/`ïŒã®å€æŽãå®è£
ãšåãã³ãããã«å
¥ããïŒåŸã®ã¬ãã¥ãŒã§èŠæãšãã£ãããšã粟æ»ãããããåãªãç¥å
ã®èŠæã®ãã©ã«ãã芪ãå¯Ÿå¿æžã«ãããšãã¯åå«ã®èŠæã®ãã©ã«ãïŒèŠéãã®åãªã©ïŒã®ãŸã å
¥ã£ãŠããªã倿Žãå
¥ããã»ãã®èŠæã»é¢ä¿ãªã倿Žã¯å
¥ããªããå€ã»ç¡èŠã»worktree ã®ãšãã¯å
¥ããªãã®ã§ãç§»åã `git add -f` ã¯ããªãïŒãpush ã«å€±æãããå®äºã®èšé²ã¯æ®ããå
¬éã§ããŠããªãããšãäŒãããèŠæã®ãã©ã«ãã¯ãããŒãžãããŸã§èŠæã®ãã©ã³ãã«ããç¡ããæ¢å®ã®ãã©ã³ãã«åãæ¿ãããšããã®èŠæïŒåãªã芪ã®åã®äžèЧãããïŒãæ¶ããããã«èŠããããããŒã¿ã¯ãã©ã³ãã«ããïŒäœãçŽããããå¥ã®ãã©ã³ãããåãããããªãïŒ
|
|
1405
|
-
- ã³ãããã PR ã® URL ã¯åŸãã `p3 move T003 done --output <URL>` ã§è¶³ãïŒå®äºã»èšé²ã¯ãã®ãŸãŸãããŒã¿ãã³ãããããŠãããªã远èšãã³ãããã㊠pushïŒãè€æ°ã®ãªããžããªã«ãŸããããšãã¯æåŸã®ã¿ã¹ã¯ã« `--repo-output <åç
§å
>=<PR ã® URL>` ã§å
šéšã® PR ãæ®ã
|
|
1406
|
-
- ã¿ã¹ã¯ã® AI ã¬ãã¥ãŒïŒ`p3 review`ïŒã¯é ŒãŸããã«å§ããªãïŒCodex ã䜿ãïŒãçµæãçç±ã«æžã¿ã«ãããåºæºã»èšŒæ ãæžãæãããããªã
|
|
1407
|
-
- 眮ãæããããã¿ã¹ã¯ïŒ`p3 ls` ã® `â»çœ®æ`ã`--json` ã® `superseded`ïŒããã¯å§ããªãã`move` ã `warnings` ãè¿ãããæ¢ããŠäººã«ç¢ºããã
|
|
1408
|
-
- 人ã®å€æã»æš©éãèŠãã»åæã厩ããã»ãã¹ããéããå
ã«é²ããªããªã©ã§ã¿ã¹ã¯ãç¶ããããªããªã£ããã`p3 block T003 --reason "<å
·äœçãªçç±>" --decision "<äººã«æ±ºããŠã»ããããš>" --json` ã§æ¢ãŸã£ãŠããçç±ãä»ãïŒéåžžã®ä¿®æ£ã»èª¿æ»ã®éäžã§ã¯äœ¿ããªãïŒãJSON ã® `block` ã§ä¿åã§ããããšã確ãããŠãããçç±ã»ãã€ããã»çããŠã»ããããšã»åéã®ãããã人ã«äŒããŠäœæ¥ãçµããïŒæ¢ãŸã£ããŸãŸå®äºã»æžã¿ã»å¯Ÿå¿æžã«é²ããªããåºæºã蚌æ ãæžãæããªãïŒãåçãåããã `p3 unblock T003 --resolution "<åç>"` ã§è§£é€ããŠåéããïŒè§£é€ã ãã§ã¯åéããªãã人ãå
ã«è§£é€ããŠãããå±¥æŽã®åçãèªãã§ç¢ºãããïŒ
|
|
1409
|
-
- äœæ¥äžã«æ°ããå¿
èŠã«ãªã£ãäœæ¥ã¯ `p3 new "<ã¿ã€ãã«>" --body "..."` ã§ã¿ã¹ã¯ã«ããïŒäººãžã®è³ªåã¯ã¿ã¹ã¯ã«ããªãïŒ
|
|
1631
|
+
<!-- p3-entry-version: 1 -->
|
|
1632
|
+
|
|
1633
|
+
- ãã®ãªããžããªã®äœæ¥ã¯ infodb p3 ã®èŠæãšã¿ã¹ã¯ã§ç®¡çãããp3 ãæäœããåã« `pnpx @infodb/p3 guide --json` ãå®è¡ããè¿ã£ã `guide`ïŒäœæ¥ã®æé ïŒãæåŸãŸã§èªãã§åŸãïŒæé ã¯åããŠãã CLI ã®çã®ãã®ãè¿ããããã«ã¯åããªãïŒ
|
|
1634
|
+
- `guide` ãååŸã§ããªããã°ïŒã³ãã³ããç¡ãã»ãšã©ãŒã«ãªãã»JSON ãèªããªãïŒãp3 ãæäœããªããåºããšã©ãŒãšåŒã³æ¹ïŒ`pnpx @infodb/p3 guide --json`ïŒã人ã«äŒããŠçµãã
|
|
1635
|
+
- åãå
¥å£ã®ã¹ãã«: `.claude/skills/p3/SKILL.md`ïŒClaude CodeïŒã»`.agents/skills/p3/SKILL.md`ïŒCodexïŒãäžèº«ã¯åã
|
|
1410
1636
|
```
|
|
1637
|
+
|
|
1638
|
+
### 眮ããå
¥å£ã®èšºæïŒ`agents`ïŒ
|
|
1639
|
+
|
|
1640
|
+
`whoami --json` ãš `guide --json` ã¯ãåã蚺æïŒ`src/cli/agentsStatus.ts` ã® `diagnoseAgents`ïŒã `agents` ã«è¿ããèªãã ãã§ã
|
|
1641
|
+
å€ããŠãæäœãæãããæžãæããããªãïŒæŽæ°ã¯äººã `p3 agents` ã§è¡ããAI ã¯äŒããã ããæé ã®ã眮ããå
¥å£ã®ç¶æ
ãïŒã
|
|
1642
|
+
|
|
1643
|
+
- 調ã¹ãã®ã¯ä»ãã git ã®äœæ¥ããªãŒã®ã«ãŒãïŒgit 管çå€ã¯ä»ããå ŽæïŒã®ãäž¡æ¹ã®ã¹ãã«ãš AGENTS.md / CLAUDE.md ã®äž¡æ¹ã®ç¯ã ã
|
|
1644
|
+
ïŒå
šãªããžããªã»å人ã®ã¹ãã«ã®å Žæã¯èŠãªãïŒã远å ã®äœæ¥ããªãŒã§èª¿ã¹ããšãã¯ãæžãå
ïŒã¡ã€ã³ã®äœæ¥ããªãŒïŒã `writeRoot` ã«åºãã
|
|
1645
|
+
æŽæ°ãããã®ããã®ãã©ã³ããžåã蟌ãããæ¡å
ãã
|
|
1646
|
+
- 圢: `{ root, writeRoot?, expectedVersion, placed, ok, entries: [{ path, kind, target?, primary?, version, status, reason }], advice, problem? }`ã
|
|
1647
|
+
`primary` ã¯ç¯ã `p3 agents` ã®æžãææžïŒAGENTS.md ãããã°ããïŒããã»ãã§èŠã€ãã£ãç¯ã
|
|
1648
|
+
- ç¶æ
: `current`ïŒçãåãã§å梱ã®å
¥å£ãšåããæ¹è¡ã®éãã»èŠåºãã®æ®µã»ç¯ã®åç
§ããã¹ãã«ã®çµã¿åããã¯èš±ãïŒã»`outdated`ïŒçãå°ããã»
|
|
1649
|
+
çã®ç¡ãåã® p3 ã®å
šæïŒã»`missing`ã»`modified`ïŒçã¯åãã§äžèº«ãéããæã§çŽããå¯èœæ§ãæ£åžžãšæå®ããªãïŒã»`newer`ïŒCLI ããæ°ããçïŒã»
|
|
1650
|
+
`unknown`ïŒçãèªããªãã»ç¯ãè€æ°ã»èŠåºãã§ãªãã»p3 ã®ã¹ãã«ã®åœ¢ã§ãªãïŒã»`unreadable`
|
|
1651
|
+
- æ¬ ããçæ¹ãå¿
é ã«ããªã: ã¹ãã«ã¯ãç¯ãåç
§ããŠããã»æ¢ã«ãããã®ã ãã調ã¹ãïŒç¡ããã° `missing`ïŒãã¹ãã«ã¯ããã®ã«ç¯ãã©ãã«ã
|
|
1652
|
+
ç¡ããã°ç¯ã `missing`ãäœãç¡ããã° `placed: false` ã§ã人ãå
ãéžãã§çœ®ãããæ¡å
ãã
|
|
1653
|
+
- æ¡å
ïŒ`advice`ïŒ: `outdated` ã¯å·®åã確ãããŠãã `--force`ã`modified`ã»`newer`ã»`unknown` ã«ã¯ `--force` ãå§ããªãïŒ`newer` ã¯å€ã CLI ã§
|
|
1654
|
+
åããŠããªããã確ãããïŒãå®è¡ããŠããçã¯ããŒã«ã«ã® `cliVersion` ã§ç€ºããææ°çã®ç
§äŒãèµ·åçµè·¯ã®æšæž¬ã§å€ãå
šäœã€ã³ã¹ããŒã«ãšæå®ããªã
|
|
1655
|
+
- 蚺æã倱æããŠã `problem` ã«å
¥ããŠè¿ãã`whoami` ã®å¯Ÿè±¡ã®æ
å ±ã guide ã®æ¬æã¯é ããªããéåžžã®åºåã§ã¯ã`whoami` ã¯ãAI ã®å
¥å£ãã®
|
|
1656
|
+
è¡ã«ã`guide` ã¯å¯Ÿå¿ãèŠããšãã ãæšæºãšã©ãŒã«èŠç¹ãšæ¬¡ã®æäœãåºã
|
|
1657
|
+
|
|
1658
|
+
### äœæ¥ã®æé ïŒ`p3 guide`ïŒ
|
|
1659
|
+
|
|
1660
|
+
眮ããã¹ãã«ã»ç¯ã¯äººãæŽæ°ããªããšå€ããŸãŸæ®ãã®ã§ãæé ã®æ¬æã¯å®è¡äžã® CLI ããèªããããã«ããïŒ`src/cli/guide.ts`ïŒã
|
|
1661
|
+
|
|
1662
|
+
- åæ¬ã¯ CLI ãšäžç·ã«é
ã `src/cli/guide.md` ã®1ã€ïŒé
åžç©ã§ã¯ `scripts/build-cli.mjs` ãåãã `lib/cli/guide.md`ïŒãæ¯åãã®åæ¬ã
|
|
1663
|
+
èªãã§è¿ããåããæããªãããªãã·ã§ã³ãªãã¯æ¬æã`--json` 㯠`{ schemaVersion, cliVersion, entryVersion, guide, agents }`ïŒ`agents` ã¯äžã®èšºæïŒ
|
|
1664
|
+
- `schemaVersion` 㯠JSON ã®åœ¢ã®çïŒ`GUIDE_SCHEMA_VERSION`ïŒã`cliVersion` ã¯å梱㮠`package.json` ã®çã§ãææ°ãã©ããã®å€æã«ã¯
|
|
1665
|
+
䜿ããªãïŒnpm ã«åãåãããªãïŒã`entryVersion`ïŒ`ENTRY_VERSION`ãæ£ã®æŽæ°ïŒã¯å
¥å£ïŒçœ®ããã¹ãã«ã»ç¯ïŒã®æ±ºãŸãã®çã§ãèµ·åã®
|
|
1666
|
+
ãããã»èªã¿èŸŒã¿ã®çŽæãªã©å
¥å£ã«æžãããšãå€ãããšãã ãäžãããæé ã®æ¬æãçŽããã ãã§ã¯äžããªã
|
|
1667
|
+
- ãããžã§ã¯ããæ±ºããåã«æ±ãïŒ`cli/main.ts`ã`agents` ãšåãäœçœ®ïŒãæªç»é²ã»ç»é²ãè€æ°ã»å£ããå人èšå®ã `project.yaml` ã§ã
|
|
1668
|
+
å
±éã®æé ãè¿ãã察象ã®ç¢ºããæ¹ïŒ`whoami` ãš `via`ïŒã¯æé ã®äžã«æžãã`guide` èªèº«ã¯å¯Ÿè±¡ãæšæž¬ããŠæäœããªã
|
|
1669
|
+
- èªãã ãïŒ`cli/readOnly.ts`ïŒãããŒã¿ã»å人èšå®ã»çœ®ãããã¡ã€ã«ãå€ãããCodexã»Dockerã»npm ãåŒã°ãªãïŒ`test/guide.test.ts`ïŒ
|
|
1670
|
+
- æé ã®åŒã³æ¹ã¯ `pnpx @infodb/p3` ãå
ã«ããæé ã®äžã® `p3 <ã³ãã³ã>` ã¯ãæé ãååŸãããšããšåãåŒã³æ¹ããšæ±ºãã
|
|
1671
|
+
ïŒå
šäœã«å
¥ããå€ã `p3` ãžåãæ¿ããããªãïŒ
|
|
1672
|
+
- 決ãŸãïŒåœ¹å²ã»çµããæ¹ïŒã®æ€æ»ã¯ `test/agents.test.ts` ãåæ¬ã«æãããé
åžç©ã§åã忬ãšçãè¿ãããšã¯
|
|
1673
|
+
`test/pack.test.ts` ãš `scripts/verify-pack.mjs`
|
|
1674
|
+
|