dw-kit 1.8.0-rc.2 → 1.9.0

package/TRADEMARK.md

@@ -0,0 +1,65 @@
+# dw-kit Trademark Policy
+
+## Marks covered
+
+The following names and logos (the "Marks") are trademarks of the dw-kit copyright holder (currently Đặng Huy / huygdv):
+
+- `dw`
+- `dw-kit`
+- `dw Platform`
+- `DW Cloud`, `DW GoalOps`, `DW Memory` (reserved for future product layers)
+- Any logo, wordmark, or icon distributed in the dw-kit repository under `/.dw/branding/` or marked as a Mark in this file
+
+The Apache License 2.0 that governs the source code **does not** grant trademark rights (see Apache 2.0 §6). This file describes what you may and may not do with the Marks.
+
+## Permitted uses (no prior permission required)
+
+You may, without asking:
+
+1. **Truthful descriptive reference.** Write articles, tutorials, blog posts, books, social posts, slide decks, or videos that mention `dw` or `dw-kit` to describe the project, compare it to alternatives, teach how to use it, or report on it. Examples:
+   - "We migrated our workflow from X to dw-kit"
+   - "dw-kit supports voice-driven agent orchestration"
+   - "Comparing dw vs Cursor for multi-agent coding"
+2. **Link to the official project.** Link to <https://github.com/dv-workflow/dv-workflow>, <https://www.npmjs.com/package/dw-kit>, or any official release announcement using the Marks as link text.
+3. **Use unmodified release artifacts.** Distribute the unmodified dw-kit npm package, source tarball, or container image with the Marks intact.
+4. **Internal use.** Use the Marks inside your organization (Slack channels, internal wikis, ticket systems, etc.) to refer to your deployment of dw-kit.
+5. **Conference talks, meetups, contributions.** Use the name when speaking about the project, contributing patches, filing issues, or running a user group.
+
+## Uses that require permission
+
+Get written permission from the copyright holder before you:
+
+1. **Distribute a modified fork using a name that includes a Mark.** A fork is fine; calling it "dw-kit Pro", "Awesome DW", "dw-cloud", "DW Plus", or any variant that could confuse users into thinking it's an official release is not.
+2. **Offer a hosted service under a Mark.** Selling or operating a SaaS, paid hosted dashboard, or managed service named "dw Cloud", "DW Hosted", "dw.io", etc., or in a way that uses the Marks to imply official endorsement.
+3. **Sell goods under a Mark.** T-shirts, stickers, merchandise, or training products that prominently use the Marks for commercial purposes outside reasonable promotional give-aways.
+4. **Use the Marks in your company name, product name, domain name, or social media handle** in a way that implies the company/product/account is the official dw-kit project.
+
+For permission, email <huygdv19@gmail.com> with a brief description of the proposed use, who you are, and the timeline.
+
+## Uses that are not permitted
+
+Even with permission, the following remain prohibited:
+
+1. **Endorsement claims.** You may not state or imply that the dw-kit project, its maintainers, or its contributors endorse, certify, recommend, or are affiliated with your product, service, fork, training course, or business unless a written agreement exists.
+2. **Confusingly similar marks.** You may not adopt logos, color schemes, or wordmarks designed to be mistaken for the Marks. Calling a fork `dw-toolkit`, `dw-workflow-kit`, or `dw-prime` falls in this bucket.
+3. **Disparagement under cover.** You may not use the Marks in materials whose primary purpose is to disparage, mislead about, or harm the dw-kit project.
+
+## Fork naming guidance
+
+Forks are explicitly encouraged by the Apache License. To name your fork in a way that does not require trademark permission:
+
+- **Good:** `acme-agent-runtime` (your own name), `MyOrgAgentOS`, `agentctl`
+- **Acceptable with attribution:** `acme-agent-runtime (based on dw-kit)`, with the relationship clearly disclosed
+- **Requires permission:** Anything that puts `dw` or `dw-kit` in the package name, binary name, or marketing copy as if it were the canonical version
+
+## Why this policy exists
+
+The Marks signal "this is the official dw-kit project, vetted and shipped by the original team." If a security issue, breaking change, or release coordination question comes up, users need a single trusted source. Trademark protection keeps that signal honest while leaving the Apache-licensed code maximally open for forking, modification, and redistribution.
+
+If you are unsure whether your intended use is permitted, ask. The default answer for friendly, reasonable, honest requests is yes.
+
+## Updates to this policy
+
+This policy may be updated. The current version always lives at <https://github.com/dv-workflow/dv-workflow/blob/main/TRADEMARK.md>. Material changes will be noted in `CHANGELOG.md`.
+
+Last updated: 2026-05-26

package/bin/dw.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 const [major] = process.versions.node.split('.').map(Number);
 if (major < 18) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dw-kit",
-  "version": "1.8.0-rc.2",
+  "version": "1.9.0",
   "description": "AI development workflow toolkit — structured, quality-assured, team-ready. From requirements to dashboard.",
   "type": "module",
   "bin": {
@@ -12,6 +12,7 @@
     "src/commands/",
     "src/lib/",
     ".dw/core/",
+    "!.dw/core/PILLARS.md",
     ".dw/config/",
     ".dw/adapters/",
     ".dw/security/",
@@ -30,6 +31,8 @@
     ".claude/skills/dw-estimate/",
     ".claude/skills/dw-execute/",
     ".claude/skills/dw-flow/",
+    ".claude/skills/dw-goal/",
+    ".claude/skills/dw-goal-sync/",
     ".claude/skills/dw-handoff/",
     ".claude/skills/dw-kit-report/",
     ".claude/skills/dw-log-work/",
@@ -48,9 +51,11 @@
     ".claude/skills/dw-upgrade/",
     ".claude/templates/",
     ".claude/settings.json",
-    "CLAUDE.md",
     "MIGRATION-v1.3.md",
-    "MIGRATION-v1.5.md"
+    "MIGRATION-v1.5.md",
+    "NOTICE",
+    "TRADEMARK.md",
+    "SECURITY.md"
   ],
   "engines": {
     "node": ">=18"
@@ -59,7 +64,10 @@
     "test": "node src/smoke-test.mjs",
     "test:renderer": "cd packages/dw-kit-render && npm test",
     "link": "npm link",
-    "test:e2e-local": "bash scripts/e2e-local-check.sh"
+    "test:e2e-local": "bash scripts/e2e-local-check.sh",
+    "gen:event-schemas": "node scripts/generate-event-schemas.mjs",
+    "audit:pack": "node scripts/audit-pack.mjs",
+    "prepublishOnly": "node scripts/audit-pack.mjs"
   },
   "keywords": [
     "ai",
@@ -73,7 +81,7 @@
     "agent"
   ],
   "author": "huygdv <huygdv19@gmail.com>",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/dv-workflow/dv-workflow.git"

package/src/cli.mjs

@@ -195,6 +195,30 @@ export function run(argv) {
       await taskSummaryCommand(taskName, opts);
     });
 
+  taskCmd
+    .command('index')
+    .description('Regenerate .dw/tasks/tasks-index.json — DW Document Schema + Index v1.0 read-contract (ADR-0017)')
+    .option('--json', 'Print the machine-readable index (for external adapters)')
+    .option('--check', 'Print the current index without rebuilding')
+    .action(async (opts) => {
+      const { taskIndexCommand } = await import('./commands/task-index.mjs');
+      await taskIndexCommand(opts);
+    });
+
+  const decisionCmd = program
+    .command('decision')
+    .description('ADR operations (ADR-0017 v1.1 document contract)');
+
+  decisionCmd
+    .command('index')
+    .description('Regenerate .dw/decisions/decisions-index.json — decisions-index@v1 read-contract (ADR-0017 v1.1; consumed by external org-memory adapters)')
+    .option('--json', 'Print the machine-readable index (for adapters)')
+    .option('--check', 'Print the current index without rebuilding')
+    .action(async (opts) => {
+      const { decisionIndexCommand } = await import('./commands/decision-index.mjs');
+      await decisionIndexCommand(opts);
+    });
+
   const agentCmd = program
     .command('agent')
     .description('Agent OS multi-agent orchestration (ADR-0009): claim · release · renew · expire · claims · reports · conflicts · check-staged · verify');
@@ -495,6 +519,15 @@ export function run(argv) {
       await goalSetCommand(goalId, opts);
     });
 
+  goalCmd
+    .command('status <goal-id> <new-status>')
+    .description('Transition lifecycle status (Draft|Active|Achieved|Pivoted); auto-bumps goal_version + emits goal_status_changed. Use `goal delete` to abandon.')
+    .option('--reason <text>', 'Optional reason, recorded in the goal_status_changed event')
+    .action(async (goalId, newStatus, opts) => {
+      const { goalStatusCommand } = await import('./commands/goal-status.mjs');
+      await goalStatusCommand(goalId, newStatus, opts);
+    });
+
   goalCmd
     .command('show [goal-id]')
     .description('ANSI snapshot of a goal (no arg = list all)')

package/src/commands/decision-index.mjs

@@ -0,0 +1,45 @@
+import chalk from 'chalk';
+import { rebuildDecisionIndex, readDecisionIndex, decisionIndexFile } from '../lib/decision-store.mjs';
+import { logEvent } from '../lib/telemetry.mjs';
+
+// `dw decision index` — regenerate .dw/decisions/decisions-index.json
+// (DW Document Schema + Index v1.0, ADR-0017 v1.1). Read-contract surface for
+// external org-memory adapters.
+//   dw decision index           rebuild + human summary
+//   dw decision index --json    rebuild + print machine-readable index
+//   dw decision index --check   print current index without rebuilding
+export async function decisionIndexCommand(opts = {}) {
+  const rootDir = process.cwd();
+  const index = opts.check ? readDecisionIndex(rootDir) : rebuildDecisionIndex(rootDir);
+
+  if (opts.json) {
+    console.log(JSON.stringify(index, null, 2));
+    logEvent({ event: 'decision', action: 'index.json', name: Object.keys(index.decisions).length }, rootDir);
+    return;
+  }
+
+  const decisions = index.decisions || {};
+  const ids = Object.keys(decisions);
+  const byStatus = {};
+  for (const id of ids) {
+    const s = decisions[id].status || 'Proposed';
+    byStatus[s] = (byStatus[s] || 0) + 1;
+  }
+
+  console.log();
+  console.log(chalk.bold(`  decisions-index (${chalk.cyan(index.schema_version)}) — ${ids.length} ADR(s)`));
+  console.log(chalk.dim(`  ${decisionIndexFile(rootDir)}`));
+  console.log();
+  if (ids.length === 0) {
+    console.log(chalk.dim('  (no ADRs — create one with /dw:decision)'));
+  } else {
+    for (const [status, n] of Object.entries(byStatus)) {
+      console.log(`  ${String(n).padStart(3)}  ${status}`);
+    }
+  }
+  console.log();
+  console.log(chalk.dim('  Tip: `dw decision index --json` for the machine-readable adapter contract.'));
+  console.log();
+
+  logEvent({ event: 'decision', action: opts.check ? 'index.check' : 'index.rebuild', name: ids.length }, rootDir);
+}

package/src/commands/goal-delete.mjs

@@ -2,7 +2,7 @@ import { readFileSync, writeFileSync, existsSync, rmSync } from 'node:fs';
 import { join } from 'node:path';
 import chalk from 'chalk';
 import { parseFrontmatter, stringifyFrontmatter } from '../lib/frontmatter.mjs';
-import { readGoal, removeIndexEntry, findLinkedTaskIds, goalDir, todayIso, nowUtc } from '../lib/goal-store.mjs';
+import { readGoal, removeIndexEntry, syncIndexEntry, findLinkedTaskIds, goalDir, todayIso, nowUtc } from '../lib/goal-store.mjs';
 import { logGoalEvent } from '../lib/goal-events.mjs';
 import { logEvent } from '../lib/telemetry.mjs';
 
@@ -94,6 +94,8 @@ export async function goalDeleteCommand(goalId, opts = {}) {
   fm.last_updated = todayIso();
   const body = content.replace(/^---\n[\s\S]*?\n---\n?/, '');
   writeFileSync(goal.file, stringifyFrontmatter(fm) + body, 'utf8');
+  // Keep goals-index in sync — otherwise `goal lint` flags status drift (#20).
+  syncIndexEntry(goalId, rootDir);
 
   logGoalEvent({
     event: 'goal_status_changed',

package/src/commands/goal-link.mjs

@@ -5,6 +5,7 @@ import { parseFrontmatter, stringifyFrontmatter } from '../lib/frontmatter.mjs';
 import { readGoal, syncIndexEntry, todayIso } from '../lib/goal-store.mjs';
 import { logGoalEvent } from '../lib/goal-events.mjs';
 import { logEvent } from '../lib/telemetry.mjs';
+import { bareSchemaVersion } from '../lib/task-store.mjs';
 
 const TASKS_DIR = '.dw/tasks';
 
@@ -17,7 +18,8 @@ function writeTaskFrontmatter(taskId, mutator, rootDir = process.cwd()) {
   const content = readFileSync(file, 'utf8');
   const fm = parseFrontmatter(content);
   const updated = mutator({ ...fm });
-  if (updated.schema_version === 'v3.0') updated.schema_version = 'v3.1';
+  // Linking goal fields requires v3.1; bump v3.0 → canonical task@v3.1 (#22).
+  if (bareSchemaVersion(updated.schema_version) === 'v3.0') updated.schema_version = 'task@v3.1';
   updated.last_updated = todayIso();
   const body = content.replace(/^---\n[\s\S]*?\n---\n?/, '');
   writeFileSync(file, stringifyFrontmatter(updated) + body, 'utf8');

package/src/commands/goal-status.mjs

@@ -0,0 +1,95 @@
+import chalk from 'chalk';
+import {
+  readGoal,
+  updateGoalFrontmatter,
+  syncIndexEntry,
+  goalStatusEnum,
+  todayIso,
+} from '../lib/goal-store.mjs';
+import { logGoalEvent } from '../lib/goal-events.mjs';
+import { logEvent } from '../lib/telemetry.mjs';
+
+// Statuses whose entry carries cascade + archive semantics owned by `goal delete`.
+const DELEGATED_STATUSES = new Set(['Abandoned']);
+// Closed states — reopening them is a backward move worth warning about.
+const CLOSED_STATUSES = new Set(['Achieved', 'Abandoned']);
+
+// Title-case a user-typed status so `active` matches the PascalCase enum (#20).
+function normalizeStatus(input, allowed) {
+  if (!input) return input;
+  const exact = allowed.find((s) => s === input);
+  if (exact) return exact;
+  return allowed.find((s) => s.toLowerCase() === input.toLowerCase()) || input;
+}
+
+export async function goalStatusCommand(goalId, newStatusRaw, opts = {}) {
+  const rootDir = process.cwd();
+
+  const allowed = goalStatusEnum(rootDir);
+  if (!goalId || !newStatusRaw) {
+    console.error(chalk.red(`✗ Usage: dw goal status <goal-id> <${allowed.join('|')}> [--reason "..."]`));
+    process.exit(1);
+  }
+
+  const newStatus = normalizeStatus(newStatusRaw, allowed);
+  if (!allowed.includes(newStatus)) {
+    console.error(chalk.red(`✗ Invalid status "${newStatusRaw}". Allowed: ${allowed.join(', ')}`));
+    process.exit(1);
+  }
+
+  // Abandonment is owned by `goal delete` (linked-task cascade + goal_archived
+  // event). Redirect rather than create a second, divergent abandon path (#20).
+  if (DELEGATED_STATUSES.has(newStatus)) {
+    console.error(chalk.red(`✗ Use \`dw goal delete ${goalId}\` to abandon a goal.`));
+    console.error(chalk.dim('  It handles linked-task cleanup (--cascade) and emits goal_archived.'));
+    process.exit(1);
+  }
+
+  const goal = readGoal(goalId, rootDir);
+  if (!goal) {
+    console.error(chalk.red(`✗ Goal ${goalId} not found`));
+    process.exit(1);
+  }
+
+  const fromStatus = goal.fm.status || 'Draft';
+  if (fromStatus === newStatus) {
+    console.log(chalk.dim(`  ${goalId} is already ${newStatus} — no change.`));
+    return;
+  }
+
+  // Warn (don't block) on reopening a closed goal — least surprise per ADR-0001.
+  if (CLOSED_STATUSES.has(fromStatus)) {
+    console.error(chalk.yellow(`  ⚠ reopening a ${fromStatus} goal → ${newStatus}`));
+  }
+
+  const changedBy = process.env.USER || process.env.USERNAME || 'unknown';
+  const oldVersion = goal.fm.goal_version || 1;
+  const newVersion = oldVersion + 1; // ADR-0010 Q4/C-1: status transitions are material → auto-bump
+
+  updateGoalFrontmatter(goalId, (fm) => {
+    fm.status = newStatus;
+    fm.goal_version = newVersion;
+    // Leaving any non-Abandoned target must clear a stale archive timestamp
+    // (schema: archived_at null = active). Covers reopen from a soft-delete.
+    if (fm.archived_at) fm.archived_at = null;
+    fm.last_updated = todayIso();
+    return fm;
+  }, rootDir);
+  syncIndexEntry(goalId, rootDir);
+
+  logGoalEvent({
+    event: 'goal_status_changed',
+    goal_id: goalId,
+    from_status: fromStatus,
+    to_status: newStatus,
+    changed_by: changedBy,
+    ...(opts.reason ? { reason: opts.reason } : {}),
+  }, rootDir);
+  logEvent({ event: 'goal', action: 'status', name: goalId, from: fromStatus, to: newStatus }, rootDir);
+
+  console.log();
+  console.log(chalk.green(`  ✓  ${chalk.bold(goalId)} status ${fromStatus} → ${newStatus} (v${oldVersion} → v${newVersion})`));
+  if (opts.reason) console.log(chalk.dim(`     Reason: ${opts.reason}`));
+  console.log(chalk.dim('     Logged to .dw/events-global.jsonl as goal_status_changed'));
+  console.log();
+}

package/src/commands/lint-task.mjs

@@ -106,6 +106,26 @@ export async function lintTaskCommand(taskName, opts = {}) {
     level,
   }, rootDir);
 
+  // tasks-index freshness advisory (ADR-0017 doc contract) — read-only, never mutates.
+  try {
+    const { readTaskIndex, listTaskIds, readTask } = await import('../lib/task-store.mjs');
+    const index = readTaskIndex(rootDir);
+    const idxKeys = new Set(Object.keys(index.tasks || {}));
+    const onDisk = listTaskIds(rootDir);
+    const missing = onDisk.filter((id) => !idxKeys.has(id));
+    let statusDrift = 0;
+    for (const id of onDisk) {
+      const entry = index.tasks?.[id];
+      if (!entry) continue;
+      const t = readTask(id, rootDir);
+      if (t && (t.fm.status || 'Draft') !== entry.status) statusDrift++;
+    }
+    if (missing.length || statusDrift) {
+      console.log(chalk.dim(`  ℹ tasks-index stale (${missing.length} unindexed, ${statusDrift} status drift) — run \`dw task index\``));
+      console.log();
+    }
+  } catch { /* advisory only */ }
+
   if (level === 'strict' && totalErrors > 0) {
     process.exit(1);
   }

package/src/commands/task-index.mjs

@@ -0,0 +1,47 @@
+import chalk from 'chalk';
+import { rebuildTaskIndex, readTaskIndex, taskIndexFile } from '../lib/task-store.mjs';
+import { logEvent } from '../lib/telemetry.mjs';
+
+// `dw task index` — regenerate .dw/tasks/tasks-index.json (DW Document Schema
+// + Index v1.0, ADR-0017). Read-only contract surface for adapters.
+//   dw task index           rebuild + human summary
+//   dw task index --json    rebuild + print machine-readable index
+//   dw task index --check    print current index without rebuilding (--json optional)
+export async function taskIndexCommand(opts = {}) {
+  const rootDir = process.cwd();
+  const index = opts.check ? readTaskIndex(rootDir) : rebuildTaskIndex(rootDir);
+
+  if (opts.json) {
+    console.log(JSON.stringify(index, null, 2));
+    logEvent({ event: 'task', action: 'index.json', name: Object.keys(index.tasks).length }, rootDir);
+    return;
+  }
+
+  const tasks = index.tasks || {};
+  const ids = Object.keys(tasks);
+  const byStatus = {};
+  for (const id of ids) {
+    const s = tasks[id].status || 'Draft';
+    byStatus[s] = (byStatus[s] || 0) + 1;
+  }
+
+  console.log();
+  console.log(chalk.bold(`  tasks-index (${chalk.cyan(index.schema_version)}) — ${ids.length} task(s)`));
+  console.log(chalk.dim(`  ${taskIndexFile(rootDir)}`));
+  console.log();
+  if (ids.length === 0) {
+    console.log(chalk.dim('  (no tasks — scaffold one with `dw task new <name>`)'));
+  } else {
+    for (const [status, n] of Object.entries(byStatus)) {
+      console.log(`  ${String(n).padStart(3)}  ${status}`);
+    }
+    const linked = ids.filter((id) => tasks[id].parent_goal_id).length;
+    console.log();
+    console.log(chalk.dim(`  ${linked}/${ids.length} linked to a parent goal`));
+  }
+  console.log();
+  console.log(chalk.dim('  Tip: `dw task index --json` for the machine-readable adapter contract.'));
+  console.log();
+
+  logEvent({ event: 'task', action: opts.check ? 'index.check' : 'index.rebuild', name: ids.length }, rootDir);
+}

package/src/commands/task-migrate.mjs

@@ -3,6 +3,7 @@ import { join } from 'node:path';
 import chalk from 'chalk';
 import { parseFrontmatter, stringifyFrontmatter } from '../lib/frontmatter.mjs';
 import { logEvent } from '../lib/telemetry.mjs';
+import { bareSchemaVersion } from '../lib/task-store.mjs';
 
 const TASKS_DIR = '.dw/tasks';
 
@@ -72,7 +73,7 @@ function mergeFrontmatter(specFm, trackingFm) {
     depth: specFm.depth || 'standard',
     related_adr: String(specFm.related_adr || 'none').match(/^(ADR-\d{4}|none)$/) ? specFm.related_adr : 'none',
     target_ship: specFm.target_ship || 'TBD',
-    schema_version: 'v3.0',
+    schema_version: 'task@v3.0',
     blockers: trackingFm.blockers || 'none',
   };
 }
@@ -308,7 +309,7 @@ function findV3Tasks(rootDir, targetSchemaVersion = 'v3.0') {
         const taskFile = join(e.path, 'task.md');
         if (!existsSync(taskFile)) return false;
         const fm = parseFrontmatter(readFileSync(taskFile, 'utf8'));
-        return fm.schema_version === targetSchemaVersion;
+        return bareSchemaVersion(fm.schema_version) === bareSchemaVersion(targetSchemaVersion);
       } catch { return false; }
     });
 }
@@ -321,16 +322,16 @@ async function migrateOneToV31(taskDir, opts) {
   }
   const content = readFileSync(taskFile, 'utf8');
   const fm = parseFrontmatter(content);
-  if (fm.schema_version === 'v3.1') {
+  if (bareSchemaVersion(fm.schema_version) === 'v3.1') {
     console.log(chalk.dim(`  · ${taskDir} — already v3.1`));
     return { ok: true, noop: true };
   }
-  if (fm.schema_version !== 'v3.0') {
+  if (bareSchemaVersion(fm.schema_version) !== 'v3.0') {
     console.log(chalk.yellow(`  ⚠  ${taskDir} — schema_version=${fm.schema_version || 'missing'}, expected v3.0 — skipping`));
     return { ok: false, skipped: true };
   }
 
-  const updated = { ...fm, schema_version: 'v3.1' };
+  const updated = { ...fm, schema_version: 'task@v3.1' };
   if (!('parent_goal_id' in updated)) updated.parent_goal_id = null;
   if (!('contributing_goal_ids' in updated)) updated.contributing_goal_ids = [];
   if (!('summary' in updated)) updated.summary = null;
@@ -457,6 +458,16 @@ export async function taskMigrateCommand(taskName, opts = {}) {
     dry_run: !!opts.dryRun,
   }, rootDir);
 
+  // Keep tasks-index@v1 current after a real migration (ADR-0017 doc contract).
+  if (!opts.dryRun && !opts.diff) {
+    try {
+      const { syncTaskIndexEntry } = await import('../lib/task-store.mjs');
+      for (const r of results) {
+        if (r.ok && !r.noop && !r.skipped) syncTaskIndexEntry(r.name, rootDir);
+      }
+    } catch { /* best-effort; `dw task index` rebuilds authoritatively */ }
+  }
+
   console.log();
   if (opts.dryRun) {
     console.log(chalk.cyan(`  Dry-run complete. Re-run without --dry-run to apply.`));

package/src/commands/task-new.mjs

@@ -76,6 +76,12 @@ export async function taskNewCommand(taskName, opts = {}) {
   const target = join(taskDir, 'task.md');
   writeFileSync(target, filled, 'utf8');
 
+  // Keep tasks-index@v1 current on creation (ADR-0017 doc contract).
+  try {
+    const { syncTaskIndexEntry } = await import('../lib/task-store.mjs');
+    syncTaskIndexEntry(slug, rootDir);
+  } catch { /* index is best-effort here; `dw task index` rebuilds authoritatively */ }
+
   logEvent({ event: 'task', action: 'new', name: slug, depth }, rootDir);
 
   console.log();

package/src/commands/task-summary.mjs

@@ -3,6 +3,7 @@ import { join } from 'node:path';
 import chalk from 'chalk';
 import { parseFrontmatter, stringifyFrontmatter } from '../lib/frontmatter.mjs';
 import { logEvent } from '../lib/telemetry.mjs';
+import { bareSchemaVersion } from '../lib/task-store.mjs';
 
 const TASKS_DIR = '.dw/tasks';
 const MAX_SUMMARY_CHARS = 1000;
@@ -38,7 +39,7 @@ export async function taskSummaryCommand(taskName, opts = {}) {
       process.exit(1);
     }
     const updated = { ...fm, summary: opts.write || null, last_updated: todayIso() };
-    if (updated.schema_version === 'v3.0') updated.schema_version = 'v3.1';
+    if (bareSchemaVersion(updated.schema_version) === 'v3.0') updated.schema_version = 'task@v3.1';
     const body = content.replace(/^---\n[\s\S]*?\n---\n?/, '');
     writeFileSync(file, stringifyFrontmatter(updated) + body, 'utf8');
 
@@ -46,8 +47,8 @@ export async function taskSummaryCommand(taskName, opts = {}) {
 
     console.log();
     console.log(chalk.green(`  ✓  Summary updated for ${chalk.bold(taskName)} (${(opts.write || '').length}/${MAX_SUMMARY_CHARS} chars)`));
-    if (fm.schema_version === 'v3.0') {
-      console.log(chalk.dim(`     Auto-bumped schema_version v3.0 → v3.1`));
+    if (bareSchemaVersion(fm.schema_version) === 'v3.0') {
+      console.log(chalk.dim(`     Auto-bumped schema_version v3.0 → task@v3.1`));
     }
     console.log();
     return;