deuk-agent-flow 4.0.37 → 4.2.7

package/scripts/cli-ticket-index.mjs

@@ -12,6 +12,34 @@ const ARCHIVE_INDEX_RETENTION_MONTHS = 12;
 const ARCHIVE_INDEX_MONTH_RE = /^INDEX\.archive\.(\d{4}-\d{2})\.json$/;
 const ARCHIVE_INDEX_LEGACY_RE = /^INDEX\.archive\.json$/;
 
+function parseNextTicketSequence(value) {
+  const raw = Number(value);
+  if (!Number.isInteger(raw) || raw < 1) return null;
+  return raw;
+}
+
+function maxTicketNumberFromEntries(entries = []) {
+  const newRe = /^([0-9]{3,4})-/;
+  let max = 0;
+  for (const e of (entries || [])) {
+    const id = String(e.id || '');
+    const m = id.match(newRe);
+    if (m) {
+      const n = parseInt(m[1], 10);
+      if (n > max) max = n;
+    }
+  }
+  return max;
+}
+
+function normalizeNextTicketSequence(nextTicketSequence, entries = []) {
+  const fallbackNum = maxTicketNumberFromEntries(entries);
+  const fallbackNext = fallbackNum < 9999 ? (fallbackNum + 1) : fallbackNum;
+  const parsed = parseNextTicketSequence(nextTicketSequence);
+  if (parsed === null) return fallbackNext || 1;
+  return Math.max(parsed, fallbackNext || 1);
+}
+
 function parseArchiveMonth(value) {
   const match = String(value || "").match(/^(\d{4})-(\d{2})$/);
   if (!match) return null;
@@ -77,7 +105,7 @@ function listArchiveIndexFiles(dir) {
 
 function parseIndexFile(absPath) {
   if (!existsSync(absPath)) {
-    return { version: 1, updatedAt: null, activeTicketId: null, entries: [] };
+    return { version: 1, updatedAt: null, activeTicketId: null, nextTicketSequence: 1, entries: [] };
   }
   try {
     const j = JSON.parse(readFileSync(absPath, "utf8"));
@@ -90,11 +118,12 @@ function parseIndexFile(absPath) {
       version: j.version || 1,
       updatedAt: j.updatedAt ?? null,
       activeTicketId: j.activeTicketId ?? null,
+      nextTicketSequence: parseNextTicketSequence(j.nextTicketSequence),
       entries
     };
   } catch (err) {
     console.error(`[ERROR] Failed to parse ${basename(absPath)} at ${absPath}:`, err.message);
-    return { version: 1, updatedAt: null, activeTicketId: null, entries: [], _corrupt: true };
+    return { version: 1, updatedAt: null, activeTicketId: null, nextTicketSequence: 1, entries: [], _corrupt: true };
   }
 }
 
@@ -151,6 +180,7 @@ export function readTicketIndexJson(cwd) {
     version: main.version || archiveFiles[0]?.version || 1,
     updatedAt: main.updatedAt ?? archiveFiles[0]?.updatedAt ?? null,
     activeTicketId: main.activeTicketId ?? null,
+    nextTicketSequence: normalizeNextTicketSequence(main.nextTicketSequence, entries),
     entries,
     _corrupt: Boolean(main._corrupt || archiveFiles.some(file => file._corrupt))
   };
@@ -168,6 +198,7 @@ export function writeTicketIndexJson(cwd, indexJson, opts = {}) {
   
   const out = { ...indexJson };
   delete out._corrupt;
+  out.nextTicketSequence = normalizeNextTicketSequence(out.nextTicketSequence, out.entries || []);
   
   // Strip physical path snapshots before saving to enforce state-driven resolution
   const entries = Array.isArray(out.entries) ? out.entries : [];
@@ -192,10 +223,11 @@ export function writeTicketIndexJson(cwd, indexJson, opts = {}) {
 
   const desiredArchiveFiles = new Set();
   for (const [yearMonth, bucket] of archiveBuckets.entries()) {
-    const archiveOut = {
+  const archiveOut = {
       version: out.version || 1,
       updatedAt: out.updatedAt || new Date().toISOString(),
       activeTicketId: null,
+      nextTicketSequence: out.nextTicketSequence,
       entries: bucket.map(e => {
         const { path, archiveDay, ...clean } = e;
         return clean;
@@ -226,22 +258,14 @@ export function getHostnameSlug() {
   }
 }
 
-export function computeNextTicketNumber(existingEntries) {
+export function computeNextTicketNumber(indexState) {
   const hostname = getHostnameSlug();
-  const newRe = /^(\d{3,4})-/;
-  let max = 0;
-  for (const e of (existingEntries || [])) {
-    const id = String(e.id || '');
-    const m = id.match(newRe);
-    if (m) {
-      const n = parseInt(m[1], 10);
-      if (n > max && n < 10000) max = n;
-    }
-  }
-  return { num: max + 1, hostname };
+  const maybeEntries = Array.isArray(indexState) ? indexState : indexState?.entries;
+  const parsedNext = normalizeNextTicketSequence(indexState?.nextTicketSequence, maybeEntries);
+  return { num: parsedNext, hostname };
 }
 
-export function generateTicketId(topicSlug, existingEntries) {
+export function generateTicketId(topicSlug, indexState) {
   const hostname = getHostnameSlug();
   const slug = requireNonEmptySlug(topicSlug, "ticket topic");
   const match = slug.match(/^(\d{3,4})-(.*)/);
@@ -250,7 +274,7 @@ export function generateTicketId(topicSlug, existingEntries) {
     const restSlug = match[2].slice(0, 32);
     return `${numStr}-${restSlug}-${hostname}`;
   }
-  const { num } = computeNextTicketNumber(existingEntries);
+  const { num } = computeNextTicketNumber(indexState);
   const numStr = String(num).padStart(3, '0');
   const finalSlug = slug.slice(0, 32);
   return `${numStr}-${finalSlug}-${hostname}`;

package/scripts/cli-ticket-parser.mjs

@@ -3,7 +3,7 @@ import { basename, dirname, join } from "path";
 import {
   AGENT_ROOT_DIR, TICKET_SUBDIR, TICKET_LIST_FILENAME,
   toPosixPath, toRepoRelativePath, detectProjectFromBody, deriveTopicFromBaseName, normalizeTicketGroup,
-  parseFrontMatter, stringifyFrontMatter, discoverAllWorkspaces, detectConsumerTicketDir,
+  parseFrontMatter, stringifyFrontMatter, discoverAllWorkspaces, detectConsumerTicketDir, computeTicketPath,
   ARCHIVE_YEAR_MONTH_RE, ARCHIVE_DAY_RE
 } from "./cli-utils.mjs";
 import { readTicketIndexJson, writeTicketIndexJson } from "./cli-ticket-index.mjs";
@@ -185,7 +185,8 @@ export function updateTicketEntryStatus(cwd, opts = {}) {
   entry.updatedAt = new Date().toISOString();
   
   // Sync status back to .md frontmatter to prevent rebuild reversion
-  const absPath = join(cwd, entry.path);
+  const entryPath = entry.path || computeTicketPath(entry);
+  const absPath = join(cwd, entryPath);
   if (existsSync(absPath)) {
     try {
       const body = readFileSync(absPath, "utf8");
@@ -199,7 +200,7 @@ export function updateTicketEntryStatus(cwd, opts = {}) {
         writeFileSync(absPath, newBody, "utf8");
       }
     } catch (err) {
-      console.warn(`[WARNING] Failed to sync status to ${entry.path}: ${err.message}`);
+      console.warn(`[WARNING] Failed to sync status to ${entryPath}: ${err.message}`);
     }
   }
 

package/scripts/lint-rules.mjs

@@ -44,6 +44,7 @@ const RULE_CHECKS = [
     test: (rules) => /Silent-by-default is mandatory/i.test(rules)
       && /Keep chat compact/i.test(rules)
       && /Final answers must be short but complete enough/i.test(rules)
+      && /do not emit a second clickable link for that ticket/i.test(rules)
       && /Commentary surface map/i.test(rules)
       && /Running-surface contract/i.test(rules)
       && /CLI running-output contract/i.test(rules)

package/scripts/smoke-npm-docker.mjs

@@ -79,7 +79,7 @@ try {
     "test -f PROJECT_RULE.md",
     "test -d .deuk-agent",
     "test ! -d .deuk-agent/templates",
-    "test -d .deuk-agent/skill-templates",
+    "test ! -d .deuk-agent/skill-templates",
   ].join("\n");
 
   run("docker", [

package/scripts/smoke-npm-local.mjs

@@ -74,6 +74,7 @@ try {
       "bin/deuk-agent-flow.js",
       "bin/deuk-agent-rule.js",
       "scripts/cli.mjs",
+      "scripts/cli-ticket-command-shared.mjs",
       "scripts/cli-ticket-commands.mjs",
       "scripts/lint-md.mjs",
       "scripts/lint-rules.mjs",

package/templates/TICKET_TEMPLATE.ko.md

@@ -5,18 +5,18 @@
 
 ## Agent Permission Contract (APC)
 
-[BOUNDARY]
+### [BOUNDARY]
 - 확인된 범위를 기준으로 정확한 수정 가능 모듈을 적습니다.
 - 생성물, 무관한 공용 영역, 외부 루트처럼 건드리면 안 되는 범위를 적습니다.
 - 이 범위를 지배하는 프로젝트 규칙과 코어 규칙을 적습니다.
 
-[CONTRACT]
+### [CONTRACT]
 - 이 티켓이 의존하는 실제 입력, 근거, 아티팩트를 적습니다.
 - 이 티켓이 만들어야 하는 실제 결과를 적습니다.
 - 허용되는 부작용과 명시적으로 제외할 항목을 적습니다.
 - 사용자가 명시적으로 요청한 경우가 아니면 테스트 작성/확장은 넣지 않습니다.
 
-[PATCH PLAN]
+### [PATCH PLAN]
 - 확인된 로컬 맥락을 기준으로 정확한 구현 경로를 적습니다.
 
 ## Compact Plan

package/templates/TICKET_TEMPLATE.md

@@ -5,18 +5,18 @@
 
 ## Agent Permission Contract (APC)
 
-[BOUNDARY]
+### [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]
+### [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]
+### [PATCH PLAN]
 - Record the exact implementation path for this ticket using confirmed local context.
 
 ## Compact Plan

package/templates/project-pilot/CONFORMANCE_GATE_TEMPLATE.md

@@ -12,6 +12,7 @@
 | Stage | Command | Expected Result | Actual Result |
 | --- | --- | --- | --- |
 | structure | | | |
+| metadata/manifest bypass | | | |
 | build/test | | | |
 | runtime/report | | | |
 
@@ -20,4 +21,5 @@
 - 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

@@ -7,6 +7,14 @@ Mark each line before implementation.
 - [ ] 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.

package/templates/skills/project-pilot/SKILL.md

@@ -1,11 +1,12 @@
 ---
 name: project-pilot
-summary: Apply the ProjectPilot Refactor Contract Kit before cross-language, generated/runtime, or repeated-drift refactors.
+summary: Apply the ProjectPilot Refactor Contract Kit before broad refactors.
 ---
 
 # ProjectPilot
 
-Authority: follow `core-rules/AGENTS.md`, the active ticket APC, Phase Gate, and project rules.
+Authority: follow `core-rules/AGENTS.md`, the active ticket APC, Phase Gate,
+and project rules.
 
 Use this skill when the task involves any of the following:
 
@@ -13,6 +14,8 @@ Use this skill when the task involves any of the following:
 - protocol, serialization, transport, codec, or table lane work
 - generated/runtime/report contract drift
 - fallback, alias, helper, no-op, placeholder, or silent stub cleanup
+- metadata, manifest, schema, generated-artifact, or report contract bypass
+  cleanup
 - convention, naming, file layout, factory surface, or lifecycle unification
 - repeated failure families where one local fix would hide shared contract drift
 
@@ -23,10 +26,14 @@ Use this skill when the task involves any of the following:
 3. Define the refactor contract before proposing or making edits.
 4. Build the implementation matrix across the relevant surfaces.
 5. Classify drift as `C`, `P`, `S`, `B`, `U`, or `D`.
-6. Identify source owners before touching source, generated, runtime, report, or template files.
-7. Fill the drift checklist and reject shortcuts that hide drift.
-8. Define the conformance gate in the ticket without creating tests unless the user requested tests.
-9. Only then split remediation tickets or implement scoped changes.
+6. Identify source owners before touching source, generated, runtime, report,
+   or template files.
+7. Identify metadata/manifest/schema contract bypasses before accepting
+   generated-output evidence.
+8. Fill the drift checklist and reject shortcuts that hide drift.
+9. Define the conformance gate in the ticket without creating tests unless the
+   user requested tests.
+10. Only then split remediation tickets or implement scoped changes.
 
 ## Required Outputs
 
@@ -51,7 +58,8 @@ Use the shared ProjectPilot semantics and templates when available:
 - `templates/project-pilot/CONFORMANCE_GATE_TEMPLATE.md`
 - `templates/project-pilot/REMEDIATION_PLAN_TEMPLATE.md`
 
-Consumer projects may keep only project-local pilot evidence and references. Shared ProjectPilot semantics and templates are owned by DeukAgentFlow.
+Consumer projects may keep only project-local pilot evidence and references.
+Shared ProjectPilot semantics and templates are owned by the upstream source of truth.
 
 ## Stop Conditions
 
@@ -59,5 +67,7 @@ Consumer projects may keep only project-local pilot evidence and references. Sha
 - No implementation matrix or refactor contract can be stated clearly.
 - Source-of-truth owner cannot be identified.
 - A fix depends on generated direct edits or hidden fallback.
+- A provider, generator, template, or report path hardcodes values that belong in
+  metadata, a manifest, schema contract, or shared conformance rule.
 - Unsupported-by-contract and broken-entrypoint are not separated.
 - Verification cannot prove the claimed alignment.

package/templates/skills/safe-refactor/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: safe-refactor
-summary: Keep refactors small, scoped, and test-backed inside DeukAgentFlow TDW.
+summary: Keep refactors small, scoped, and test-backed.
 ---
 
 # Safe Refactor

package/docs/badges/npm-downloads.json

@@ -1,8 +0,0 @@
-{
-  "schemaVersion": 1,
-  "label": "deuk-flow downloads",
-  "message": "1.8K/last-month",
-  "color": "2f6fed",
-  "namedLogo": "npm",
-  "cacheSeconds": 86400
-}