deuk-agent-flow 4.2.7 → 5.0.2

package/templates/TICKET_TEMPLATE.ko.md

@@ -1,44 +1,48 @@
----
-<%- frontmatter %>
----
-# <%= meta.title %>
-
-## Agent Permission Contract (APC)
-
-### [BOUNDARY]
-- 확인된 범위를 기준으로 정확한 수정 가능 모듈을 적습니다.
-- 생성물, 무관한 공용 영역, 외부 루트처럼 건드리면 안 되는 범위를 적습니다.
-- 이 범위를 지배하는 프로젝트 규칙과 코어 규칙을 적습니다.
-
-### [CONTRACT]
-- 이 티켓이 의존하는 실제 입력, 근거, 아티팩트를 적습니다.
-- 이 티켓이 만들어야 하는 실제 결과를 적습니다.
-- 허용되는 부작용과 명시적으로 제외할 항목을 적습니다.
-- 사용자가 명시적으로 요청한 경우가 아니면 테스트 작성/확장은 넣지 않습니다.
-
-### [PATCH PLAN]
-- 확인된 로컬 맥락을 기준으로 정확한 구현 경로를 적습니다.
-
-## Compact Plan
-
-- 실제로 확인한 문제, 선택한 접근, 가장 작은 검증 대상을 적습니다.
-
-## Problem Analysis
-
-- 확인된 관측을 바탕으로 실제 불일치, 실패, 요청 내용을 적습니다.
-
-## Source Observations
-
-- 파일, 명령, diff, 문서, 이전 티켓 기록에서 확인한 실제 근거를 적습니다.
-
-## Cause Hypotheses
-
-- 현재 가장 유력한 설명과 아직 경쟁 중인 다른 가설을 적습니다.
-
-## Improvement Direction
-
-- 선택한 방향, 범위 경계, 이 경로를 택한 이유를 적습니다.
-
-## Audit Evidence
-
-- 승인 전과 실행 전까지 확인한 사실과 명령을 적습니다.
+---
+<%- frontmatter %>
+---
+# <%= meta.title %>
+
+## Agent Permission Contract (APC)
+
+### [BOUNDARY]
+- 수정 가능:
+- 보호 범위:
+- 적용 규칙:
+
+### [CONTRACT]
+- 입력/근거:
+- 기대 결과:
+- 허용 부작용:
+- 제외:
+
+### [PATCH PLAN]
+- 구현 경로:
+
+## Compact Plan
+
+- Problem:
+- Approach:
+- Verification:
+
+## Problem Analysis
+
+- 
+
+## Source Observations
+
+- 
+
+## Cause Hypotheses
+
+- 
+
+## Improvement Direction
+
+- 
+
+## Audit Evidence
+
+- Core rules:
+- Project rules:
+- Commands/evidence:

package/templates/TICKET_TEMPLATE.md

@@ -1,44 +1,48 @@
----
-<%- frontmatter %>
----
-# <%= meta.title %>
-
-## Agent Permission Contract (APC)
-
-### [BOUNDARY]
-- Record the exact editable modules for this ticket using confirmed scope.
-- Record forbidden/generated/unrelated areas that must stay untouched.
-- Cite the governing project/core rule set that defines the boundary.
-
-### [CONTRACT]
-- Record the concrete inputs, artifacts, or local evidence this ticket depends on.
-- Record the concrete output expected from this ticket.
-- Record allowed side effects and anything explicitly excluded.
-- Do not include test creation or test expansion unless the user explicitly requested tests.
-
-### [PATCH PLAN]
-- Record the exact implementation path for this ticket using confirmed local context.
-
-## Compact Plan
-
-- Record the concrete finding, chosen approach, and smallest verification target.
-
-## Problem Analysis
-
-- Record the actual mismatch, failure, or request using confirmed observations.
-
-## Source Observations
-
-- Record concrete local evidence from files, commands, diffs, docs, or prior ticket history.
-
-## Cause Hypotheses
-
-- Record the current best explanation and the alternatives still under consideration.
-
-## Improvement Direction
-
-- Record the chosen direction, scope boundaries, and why this path is being taken.
-
-## Audit Evidence
-
-- Record the confirmed facts and commands gathered before approval and execution.
+---
+<%- frontmatter %>
+---
+# <%= meta.title %>
+
+## Agent Permission Contract (APC)
+
+### [BOUNDARY]
+- Editable:
+- Protected:
+- Governing rules:
+
+### [CONTRACT]
+- Inputs/evidence:
+- Expected output:
+- Allowed side effects:
+- Excluded:
+
+### [PATCH PLAN]
+- Implementation path:
+
+## Compact Plan
+
+- Problem:
+- Approach:
+- Verification:
+
+## Problem Analysis
+
+- 
+
+## Source Observations
+
+- 
+
+## Cause Hypotheses
+
+- 
+
+## Improvement Direction
+
+- 
+
+## Audit Evidence
+
+- Core rules:
+- Project rules:
+- Commands/evidence:

package/templates/project-memory.md

@@ -0,0 +1,19 @@
+# Project Memory
+
+> 이 파일은 에이전트가 매 세션마다 컨텍스트를 재수집하지 않도록 프로젝트 맥락을 기록합니다.
+> `deuk-agent-flow rules` 출력에 자동 포함됩니다.
+> 큰 결정이 있을 때 이 파일(project-memory.md)만 직접 편집해 갱신하세요. 티켓 자체(.md·프론트매터·docmeta·INDEX.json)는 절대 손으로 고치지 말고 deuk-agent-flow CLI로만 변경하세요 — 승인 게이트 우회 금지.
+
+## Current Architecture State
+<!-- 지금 코드베이스가 어떤 모양인지 — 주요 모듈, 레이어, 인터페이스 요약 -->
+
+## Active Refactoring Direction
+<!-- 진행 중인 큰 방향 — 예: "syntax.ts → YAML 전환 중", "agentd TS 단일화" -->
+
+## Key Decisions Log
+| 날짜 | 결정 | 이유 |
+|------|------|------|
+| <!-- YYYY-MM-DD --> | <!-- 결정 내용 --> | <!-- 이유 --> |
+
+## Milestones
+- [ ] <!-- 진행 중인 것 -->

package/templates/project-pilot/CONFORMANCE_GATE_TEMPLATE.md

@@ -1,25 +1,25 @@
-# Conformance Gate Template
-
-## Pre-Implementation
-
-- Implementation matrix exists:
-- Refactor contract exists:
-- Owner map exists:
-- Drift checklist completed:
-
-## Verification Commands
-
-| Stage | Command | Expected Result | Actual Result |
-| --- | --- | --- | --- |
-| structure | | | |
-| metadata/manifest bypass | | | |
-| build/test | | | |
-| runtime/report | | | |
-
-## Exit Criteria
-
-- Contract and implementation agree.
-- Unsupported paths are explicit.
-- Generated/runtime/report outputs match the intended owner path.
-- Metadata/manifest/schema bypass findings are absent or recorded as blocking remediation.
-- Residual risks are recorded.
+# Conformance Gate Template
+
+## Pre-Implementation
+
+- Implementation matrix exists:
+- Refactor contract exists:
+- Owner map exists:
+- Drift checklist completed:
+
+## Verification Commands
+
+| Stage | Command | Expected Result | Actual Result |
+| --- | --- | --- | --- |
+| structure | | | |
+| metadata/manifest bypass | | | |
+| build/test | | | |
+| runtime/report | | | |
+
+## Exit Criteria
+
+- Contract and implementation agree.
+- Unsupported paths are explicit.
+- Generated/runtime/report outputs match the intended owner path.
+- Metadata/manifest/schema bypass findings are absent or recorded as blocking remediation.
+- Residual risks are recorded.

package/templates/project-pilot/DRIFT_CHECKLIST.md

@@ -1,27 +1,27 @@
-# Drift Checklist
-
-Mark each line before implementation.
-
-- [ ] No silent fallback remains in the touched path.
-- [ ] No alias-only path is being treated as a real contract.
-- [ ] No no-op or placeholder path is being counted as support.
-- [ ] No generated artifact is being edited directly.
-- [ ] No single-language patch is being presented as a shared fix.
-- [ ] No provider/generator/template/report path hardcodes metadata-owned
-      protocol method spellings.
-- [ ] No generated record format surface is hardcoded outside protocol contract
-      or generated-artifact manifest ownership.
-- [ ] No schema JSON is embedded directly where schema metadata or manifest
-      ownership is required.
-- [ ] No DpField-style helper is selected directly where shared runtime contract
-      ownership is required.
-- [ ] No unsupported-by-contract path is being mislabeled as broken.
-- [ ] No broken-entrypoint is being hidden as unsupported.
-- [ ] Error behavior is explicit and testable.
-- [ ] Verification covers the actual owner path.
-
-## Known Exceptions
-
-| Exception | Reason | Guard |
-| --- | --- | --- |
-| | | |
+# Drift Checklist
+
+Mark each line before implementation.
+
+- [ ] No silent fallback remains in the touched path.
+- [ ] No alias-only path is being treated as a real contract.
+- [ ] No no-op or placeholder path is being counted as support.
+- [ ] No generated artifact is being edited directly.
+- [ ] No single-language patch is being presented as a shared fix.
+- [ ] No provider/generator/template/report path hardcodes metadata-owned
+      protocol method spellings.
+- [ ] No generated record format surface is hardcoded outside protocol contract
+      or generated-artifact manifest ownership.
+- [ ] No schema JSON is embedded directly where schema metadata or manifest
+      ownership is required.
+- [ ] No DpField-style helper is selected directly where shared runtime contract
+      ownership is required.
+- [ ] No unsupported-by-contract path is being mislabeled as broken.
+- [ ] No broken-entrypoint is being hidden as unsupported.
+- [ ] Error behavior is explicit and testable.
+- [ ] Verification covers the actual owner path.
+
+## Known Exceptions
+
+| Exception | Reason | Guard |
+| --- | --- | --- |
+| | | |

package/templates/project-pilot/FLOW_CONTRACT_TEMPLATE.md

@@ -1,26 +1,26 @@
-# Flow Contract Template
-
-## Flow Identity
-
-- Workflow or call path:
-- Trigger:
-- Expected owner:
-
-## Steps
-
-| Step | Surface | Contract | Evidence |
-| --- | --- | --- | --- |
-| | | | |
-
-## Flow Rules
-
-- Required order:
-- Required handoff:
-- Forbidden shortcut:
-- Verification point:
-
-## Exceptions
-
-| Exception | Scope | Required guard |
-| --- | --- | --- |
-| | | |
+# Flow Contract Template
+
+## Flow Identity
+
+- Workflow or call path:
+- Trigger:
+- Expected owner:
+
+## Steps
+
+| Step | Surface | Contract | Evidence |
+| --- | --- | --- | --- |
+| | | | |
+
+## Flow Rules
+
+- Required order:
+- Required handoff:
+- Forbidden shortcut:
+- Verification point:
+
+## Exceptions
+
+| Exception | Scope | Required guard |
+| --- | --- | --- |
+| | | |

package/templates/project-pilot/IMPLEMENTATION_MATRIX_TEMPLATE.md

@@ -1,30 +1,30 @@
-# Implementation Matrix Template
-
-## Target
-
-- Feature or contract family:
-- Matrix axis A:
-- Matrix axis B:
-
-## Status Codes
-
-| Code | Meaning |
-| --- | --- |
-| `C` | complete |
-| `P` | partial |
-| `S` | stub |
-| `B` | broken-entrypoint |
-| `U` | unsupported-by-contract |
-| `D` | documented exception |
-
-## Matrix
-
-| Axis A | Axis B | Status | Evidence | Owner | Action |
-| --- | --- | --- | --- | --- | --- |
-| | | | | | |
-
-## Notes
-
-- Hidden shortcut candidates:
-- Split candidates:
-- Explicit unsupported paths:
+# Implementation Matrix Template
+
+## Target
+
+- Feature or contract family:
+- Matrix axis A:
+- Matrix axis B:
+
+## Status Codes
+
+| Code | Meaning |
+| --- | --- |
+| `C` | complete |
+| `P` | partial |
+| `S` | stub |
+| `B` | broken-entrypoint |
+| `U` | unsupported-by-contract |
+| `D` | documented exception |
+
+## Matrix
+
+| Axis A | Axis B | Status | Evidence | Owner | Action |
+| --- | --- | --- | --- | --- | --- |
+| | | | | | |
+
+## Notes
+
+- Hidden shortcut candidates:
+- Split candidates:
+- Explicit unsupported paths:

package/templates/project-pilot/INTEGRATION_CONTRACT_TEMPLATE.md

@@ -1,26 +1,26 @@
-# Integration Contract Template
-
-## Integration Identity
-
-- Connected surfaces:
-- Shared contract:
-- Expected direction:
-
-## Surface Rules
-
-| Surface | Responsibility | Input | Output | Owner |
-| --- | --- | --- | --- | --- |
-| | | | | |
-
-## Drift Risks
-
-- Alias risk:
-- Fallback risk:
-- Generated/source mismatch risk:
-- Report/test mismatch risk:
-
-## Verification
-
-- Minimum command:
-- Expected proof:
-- Residual risk:
+# Integration Contract Template
+
+## Integration Identity
+
+- Connected surfaces:
+- Shared contract:
+- Expected direction:
+
+## Surface Rules
+
+| Surface | Responsibility | Input | Output | Owner |
+| --- | --- | --- | --- | --- |
+| | | | | |
+
+## Drift Risks
+
+- Alias risk:
+- Fallback risk:
+- Generated/source mismatch risk:
+- Report/test mismatch risk:
+
+## Verification
+
+- Minimum command:
+- Expected proof:
+- Residual risk:

package/templates/project-pilot/OWNER_MAP_TEMPLATE.md

@@ -1,15 +1,15 @@
-# Owner Map Template
-
-| Symptom Surface | Source of Truth | Editable Here | Regeneration or Sync Command | Notes |
-| --- | --- | --- | --- | --- |
-| generated file | | yes/no | | |
-| runtime implementation | | yes/no | | |
-| report output | | yes/no | | |
-| template | | yes/no | | |
-| contract data | | yes/no | | |
-
-## Owner Decision
-
-- Primary owner:
-- Secondary owner:
-- Do-not-edit surfaces:
+# Owner Map Template
+
+| Symptom Surface | Source of Truth | Editable Here | Regeneration or Sync Command | Notes |
+| --- | --- | --- | --- | --- |
+| generated file | | yes/no | | |
+| runtime implementation | | yes/no | | |
+| report output | | yes/no | | |
+| template | | yes/no | | |
+| contract data | | yes/no | | |
+
+## Owner Decision
+
+- Primary owner:
+- Secondary owner:
+- Do-not-edit surfaces:

package/templates/project-pilot/PROJECT_PILOT_RULE_TEMPLATE.md

@@ -1,34 +1,34 @@
-# ProjectPilot Rule Template
-
-## Scope
-
-- Product:
-- Shared refactor contract:
-- Generated/source/runtime boundaries:
-
-## Mandatory Gates
-
-1. Build an implementation matrix before cross-surface edits.
-2. Classify `B`, `S`, `P`, `U`, and documented exceptions separately.
-3. Identify the source owner before touching any generated or report artifact.
-4. Define the conformance gate before implementation.
-
-## Prohibited Shortcuts
-
-- Silent fallback
-- Alias-only compatibility patch
-- No-op implementation presented as support
-- Generated artifact direct edit
-- Single-language patch presented as shared fix
-
-## Required Evidence
-
-- File and line references:
-- Verification commands:
-- Contract references:
-
-## Project Exceptions
-
-| Exception | Why allowed | Guard |
-| --- | --- | --- |
-| | | |
+# ProjectPilot Rule Template
+
+## Scope
+
+- Product:
+- Shared refactor contract:
+- Generated/source/runtime boundaries:
+
+## Mandatory Gates
+
+1. Build an implementation matrix before cross-surface edits.
+2. Classify `B`, `S`, `P`, `U`, and documented exceptions separately.
+3. Identify the source owner before touching any generated or report artifact.
+4. Define the conformance gate before implementation.
+
+## Prohibited Shortcuts
+
+- Silent fallback
+- Alias-only compatibility patch
+- No-op implementation presented as support
+- Generated artifact direct edit
+- Single-language patch presented as shared fix
+
+## Required Evidence
+
+- File and line references:
+- Verification commands:
+- Contract references:
+
+## Project Exceptions
+
+| Exception | Why allowed | Guard |
+| --- | --- | --- |
+| | | |

package/templates/project-pilot/REFACTOR_CONTRACT_TEMPLATE.md

@@ -1,32 +1,32 @@
-# Refactor Contract Template
-
-## Contract Identity
-
-- Feature or protocol:
-- Canonical entrypoint:
-- Supported callers:
-
-## Input Shape
-
-- Required inputs:
-- Optional inputs:
-- Invalid inputs:
-
-## Result Shape
-
-- Success result:
-- Error result:
-- Unsupported result:
-
-## Shared Guarantees
-
-- Naming rule:
-- Ownership rule:
-- Fail-fast rule:
-- Generated/runtime alignment rule:
-
-## Exceptions
-
-| Exception | Scope | Required evidence |
-| --- | --- | --- |
-| | | |
+# Refactor Contract Template
+
+## Contract Identity
+
+- Feature or protocol:
+- Canonical entrypoint:
+- Supported callers:
+
+## Input Shape
+
+- Required inputs:
+- Optional inputs:
+- Invalid inputs:
+
+## Result Shape
+
+- Success result:
+- Error result:
+- Unsupported result:
+
+## Shared Guarantees
+
+- Naming rule:
+- Ownership rule:
+- Fail-fast rule:
+- Generated/runtime alignment rule:
+
+## Exceptions
+
+| Exception | Scope | Required evidence |
+| --- | --- | --- |
+| | | |