@dtlabs/ai-toolkit 0.2.0 → 0.2.2

package/.claude/agents/validate-feature-docs.md

@@ -123,6 +123,8 @@ For each document with gaps, invoke the corresponding agent with a **targeted re
 
 ## Phase 6 — Write Validation Report
 
+**Always execute this phase**, regardless of whether gaps were found. The report is required even when validation is clean.
+
 Write `{PREFIX}-Validation-Report.md` in the same directory:
 
 ```markdown

package/.claude/workflows/pm-phase1.js

@@ -113,8 +113,9 @@ for (let cycle = 1; cycle <= MAX_CYCLES; cycle++) {
   tokenLedger.push({ agent: `validate-feature-docs (cycle ${cycle})`, model: 'haiku', phase_delta_tokens: valTokens })
 
   // valResult is the agent's text output — check for gap indicators
+  // Use only 'MISSING:' as the gap signal: 'gaps found' also matches 'ZERO GAPS FOUND'
   const resultText = typeof valResult === 'string' ? valResult : JSON.stringify(valResult)
-  const hasGaps    = resultText.includes('MISSING:') || resultText.toLowerCase().includes('gaps found')
+  const hasGaps    = resultText.includes('MISSING:')
 
   if (!hasGaps) {
     validationSummary = `0 gaps (clean on cycle ${cycle})`
@@ -138,6 +139,46 @@ for (let cycle = 1; cycle <= MAX_CYCLES; cycle++) {
   }
 }
 
+// ── Write process-log (phase 1 snapshot) ─────────────────────────────────────
+const reqEntry   = tokenLedger.find(e => e.agent === 'generate-requirements')
+const specEntry  = tokenLedger.find(e => e.agent === 'generate-tech-spec')
+const valEntries = tokenLedger.filter(e => e.agent.startsWith('validate-feature-docs'))
+const phase1Events = [
+  `pm-phase1 START — documentation phase`,
+  reqEntry
+    ? `Agent DONE: generate-requirements — tokens: ${reqEntry.phase_delta_tokens}`
+    : `generate-requirements: skipped (fresh)`,
+  specEntry
+    ? `Agent DONE: generate-tech-spec — tokens: ${specEntry.phase_delta_tokens}`
+    : `generate-tech-spec: skipped (fresh)`,
+  ...valEntries.map(e => `Agent DONE: ${e.agent} — tokens: ${e.phase_delta_tokens}`),
+  `Validation result: ${validationSummary}`,
+  `APPROVAL REQUESTED — Gate 1`,
+].join('\n')
+
+await agent(
+  `Create the process-log file for this feature delivery run.
+
+File path: ${feature_dir}/${prefix}-process-log.txt
+
+Steps:
+1. Get current UTC datetime via Bash: run \`date -u +"%Y-%m-%dT%H:%M:%S"\`
+2. Read feature.md at: ${featurePath} — extract the feature title (first H1 heading after the frontmatter).
+3. Write the file using the Write tool. Use the datetime from step 1 for ALL timestamps.
+   Format each event line as: [{datetime}] {event text}
+
+File structure:
+════════════════════════════════════════════════════════
+RUN STARTED — {datetime}
+Feature: ${prefix} — {title from step 2}
+════════════════════════════════════════════════════════
+{one line per event below, each prefixed with [{datetime}]}
+
+Events to log:
+${phase1Events}`,
+  { label: 'write-process-log', phase: 'Validation' }
+)
+
 // ── Build gate1_payload ───────────────────────────────────────────────────────
 const gate1Payload = {
   prefix,

package/.claude/workflows/pm-phase2.js

@@ -92,6 +92,33 @@ Return the extracted metrics as structured output.`,
 log(`WB parsed: ${metrics.user_stories} US, ${metrics.total_tasks} tasks, ${metrics.implementation_phases} phases`)
 log(`Effort-Estimate written: ${metrics.effort_estimate_path}`)
 
+// ── Append to process-log (phase 2 events) ───────────────────────────────────
+const wbEntry = tokenLedger.find(e => e.agent === 'generate-work-breakdown')
+const phase2Events = [
+  `APPROVAL GRANTED by user — Gate 1`,
+  `pm-phase2 START — work breakdown phase`,
+  `Agent DONE: generate-work-breakdown — tokens: ${wbEntry ? wbEntry.phase_delta_tokens : 'N/A'}`,
+  `Written: ${metrics.prefix}-Work-Breakdown.md (${metrics.user_stories} US, ${metrics.total_tasks} tasks, ${metrics.implementation_phases} phases)`,
+  `Written: ${metrics.prefix}-Effort-Estimate.md`,
+  `pm-phase2 COMPLETE`,
+  `APPROVAL REQUESTED — Gate 2`,
+].join('\n')
+
+await agent(
+  `Append phase 2 events to the process-log for this feature delivery run.
+
+Process-log path: ${metrics.feature_dir}/${metrics.prefix}-process-log.txt
+
+Steps:
+1. Get current UTC datetime via Bash: run \`date -u +"%Y-%m-%dT%H:%M:%S"\`
+2. Append the following lines to the existing file. Use the datetime from step 1 for ALL event lines.
+   Format each event line as: [{datetime}] {event text}
+
+Events to append:
+${phase2Events}`,
+  { label: 'append-process-log', phase: 'Effort Estimate' }
+)
+
 return {
   prefix:                metrics.prefix,
   feature_path:          featurePath,

package/.claude/workflows/pm-phase3.js

@@ -297,6 +297,41 @@ const actualsTokens = budget.spent() - beforeActuals
 tokenLedger.push({ agent: 'write-actuals', model: 'sonnet', phase_delta_tokens: actualsTokens })
 log(`Actuals written | phase delta: ${actualsTokens} tokens`)
 
+// ── Append to process-log (phase 3 events + RUN COMPLETE) ────────────────────
+const usPassed    = (implResult.us_passed    || []).join(', ') || 'none'
+const usEscalated = (implResult.us_escalated || []).join(', ') || 'none'
+const phase3Events = [
+  `APPROVAL GRANTED by user — Gate 2`,
+  `pm-phase3 START — implementation phase — branch: ${branch || '(current)'}`,
+  `Implementation DONE — ${implResult.phases_done} phases | US passed: ${usPassed} | US escalated: ${usEscalated}`,
+  issuesFixed + issuesDeferred > 0
+    ? `Remediation: ${issuesFixed} fixed, ${issuesDeferred} deferred`
+    : `Remediation: skipped (no open issues)`,
+  `PR created: ${prResult.pr_url}`,
+  `Actuals written: Token-Estimate.md + Effort-Estimate.md`,
+  `RUN COMPLETE`,
+  `════════════════════════════════════════════════════════`,
+].join('\n')
+
+// feature_dir is not directly available in pm-phase3; derive from featurePath
+const featureDir3 = featurePath.replace(/\/[^/]+$/, '')
+
+await agent(
+  `Append phase 3 events to the process-log for this feature delivery run.
+
+Process-log path: ${featureDir3}/${prefix}-process-log.txt
+
+Steps:
+1. Get current UTC datetime via Bash: run \`date -u +"%Y-%m-%dT%H:%M:%S"\`
+2. Append the following lines to the existing file. Use the datetime from step 1 for ALL event lines.
+   Format each event line as: [{datetime}] {event text}
+   The final line (════…) is a separator — append it as-is, without a timestamp prefix.
+
+Events to append:
+${phase3Events}`,
+  { label: 'finalize-process-log', phase: 'Actuals' }
+)
+
 return {
   pr_url:       prResult.pr_url,
   token_ledger: tokenLedger,

package/CHANGELOG.md

@@ -1,4 +1,20 @@
 ## 0.1.4 (2026-07-21)
+## [0.2.2](https://github.com/dtlab-tech/ai-toolkit/compare/v0.2.1...v0.2.2) (2026-07-28)
+
+
+### Bug Fixes
+
+* restore process-log trace across pm-phase1/2/3 workflow scripts ([6748cf9](https://github.com/dtlab-tech/ai-toolkit/commit/6748cf9aab94efc76aa41c6c97cfe9493bc8db92))
+* restore process-log trace across pm-phase1/2/3 workflow scripts ([844965a](https://github.com/dtlab-tech/ai-toolkit/commit/844965abe5f0486cc5915819e5879b0486a3e993))
+
+## [0.2.1](https://github.com/dtlab-tech/ai-toolkit/compare/v0.2.0...v0.2.1) (2026-07-27)
+
+
+### Bug Fixes
+
+* validate-feature-docs always writes report; fix false-positive gap detection ([68caf3e](https://github.com/dtlab-tech/ai-toolkit/commit/68caf3e25214bcb219df1654c4b3ede5cc42eb3b))
+* validate-feature-docs always writes report; fix false-positive gap detection in pm-phase1 ([d99fdb3](https://github.com/dtlab-tech/ai-toolkit/commit/d99fdb39be1663539bd0ed7e6ca4facc2c53fd76))
+
 ## [0.2.0](https://github.com/dtlab-tech/ai-toolkit/compare/v0.1.7...v0.2.0) (2026-07-27)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dtlabs/ai-toolkit",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "AI Toolkit — reusable agents and procedures for developers to build AI-powered applications.",
   "files": [
     "docs/",