wize-dev-kit 0.15.0 → 0.16.0

package/tools/installer/document-project/modes/quick.js

@@ -1,211 +0,0 @@
-// Quick baseline mode for `wize-dev-kit document-project`.
-//
-// Produces the 6 lightweight baseline files. Does not read source files.
-
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-const BASELINE_FILES = {
-  'overview.md': overviewMarkdown,
-  'architecture-snapshot.md': architectureMarkdown,
-  'conventions.md': conventionsMarkdown,
-  'dependencies.md': dependenciesMarkdown,
-  'risk-spots.md': riskMarkdown,
-  'open-questions.md': questionsMarkdown
-};
-
-function now() {
-  return new Date().toISOString().slice(0, 10);
-}
-
-function readPackage(root) {
-  try {
-    return JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf-8'));
-  } catch {
-    return {};
-  }
-}
-
-function countLines(root) {
-  let total = 0;
-  const dirs = ['src', 'tools', 'adapters', 'schemas', 'test'];
-  for (const dir of dirs) {
-    const full = path.join(root, dir);
-    if (!fs.existsSync(full)) continue;
-    total += walkLines(full);
-  }
-  return total;
-}
-
-function walkLines(dir) {
-  let total = 0;
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  for (const e of entries) {
-    const full = path.join(dir, e.name);
-    if (e.isDirectory()) total += walkLines(full);
-    else if (e.isFile() && /\.(js|md|yaml|json)$/.test(e.name)) {
-      const content = fs.readFileSync(full, 'utf-8');
-      total += content.split('\n').length;
-    }
-  }
-  return total;
-}
-
-function recentCommitCount(root) {
-  // Avoid shelling out; return 0 if not a git repo or git unavailable.
-  // Caller can overlay a real count from CLI.
-  return 0;
-}
-
-function overviewMarkdown(root, pkg) {
-  return `---
-status: baseline
-owner: Pepper Potts + Peggy Carter
-created: ${now()}
-last_refreshed: ${now()}
----
-
-# Overview
-
-**Project:** ${pkg.name || path.basename(root)}
-**What it is:** ${pkg.description || 'Project documented by Wize Dev Kit.'}
-**Current version:** ${pkg.version || 'unknown'}
-
-## Size
-
-- Source lines of code: ~${countLines(root)} LOC.
-- Runtime dependencies: ${Object.keys(pkg.dependencies || {}).length}.
-- Dev dependencies: ${Object.keys(pkg.devDependencies || {}).length}.
-
-## What it ships
-
-- See architecture-snapshot.md for components and entry points.
-- See conventions.md for coding patterns.
-- See dependencies.md for runtime and dev dependency roles.
-`;
-}
-
-function architectureMarkdown() {
-  return `---
-status: baseline
-owner: Pepper Potts + Tony Stark
-created: ${now()}
-last_refreshed: ${now()}
----
-
-# Architecture Snapshot
-
-## Entry points
-
-- Documented after a deeper scan (initial_scan mode).
-
-## Components
-
-- Run \`wize-dev-kit document-project initial_scan deep\` for component-level detail.
-
-## Integration surface
-
-- See dependencies.md for external integrations.
-`;
-}
-
-function conventionsMarkdown() {
-  return `---
-status: baseline
-owner: Peggy Carter
-created: ${now()}
-last_refreshed: ${now()}
-sampled: "pending deeper scan"
----
-
-# Conventions (observed, not prescribed)
-
-## Quick notes
-
-- Run \`wize-dev-kit document-project initial_scan deep\` to sample files and fill this doc.
-`;
-}
-
-function dependenciesMarkdown(root, pkg) {
-  const runtime = Object.entries(pkg.dependencies || {})
-    .map(([name, version]) => `| ${name} | ${version} | | |`).join('\n');
-  const dev = Object.entries(pkg.devDependencies || {})
-    .map(([name, version]) => `| ${name} | ${version} | | |`).join('\n');
-
-  return `---
-status: baseline
-owner: Pepper Potts
-created: ${now()}
-last_refreshed: ${now()}
----
-
-# Dependencies
-
-## Runtime
-
-| Name | Version | Role in this repo | Load-bearing? |
-|---|---|---|---|
-${runtime || '| — | — | — | — |'}
-
-## Dev / bundled
-
-| Name | Version | Role in this repo | Load-bearing? |
-|---|---|---|---|
-${dev || '| — | — | — | — |'}
-`;
-}
-
-function riskMarkdown() {
-  return `---
-status: baseline
-owner: Pepper Potts + Tony Stark
-created: ${now()}
-last_refreshed: ${now()}
----
-
-# Risk Spots
-
-| Area | Symptom | Likely cause | Confidence |
-|---|---|---|---|
-| | | | |
-
-Run \`wize-dev-kit document-project initial_scan deep\` to populate risk spots.
-`;
-}
-
-function questionsMarkdown() {
-  return `---
-status: baseline
-owner: Pepper Potts + Peggy Carter
-created: ${now()}
-last_refreshed: ${now()}
----
-
-# Open Questions
-
-| Question | Why it matters | Owner to ask |
-|---|---|---|
-| | | |
-`;
-}
-
-function runQuick(projectRoot, opts = {}) {
-  const pkg = readPackage(projectRoot);
-  const dir = path.join(projectRoot, '.wize', 'knowledge', 'document-project');
-  fs.mkdirSync(dir, { recursive: true });
-
-  const written = [];
-  for (const [name, factory] of Object.entries(BASELINE_FILES)) {
-    const file = path.join(dir, name);
-    const content = factory(projectRoot, pkg);
-    fs.writeFileSync(file, content, 'utf-8');
-    written.push(name);
-  }
-
-  if (opts.log) opts.log(`Quick baseline written to ${dir}`);
-  return { changed: true, mode: 'quick', written };
-}
-
-module.exports = { runQuick, BASELINE_FILES, countLines };

package/tools/installer/document-project/render-index.js

@@ -1,101 +0,0 @@
-// Master index renderer for `wize-dev-kit document-project`.
-//
-// Generates `.wize/knowledge/document-project/index.md` linking all docs.
-
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-function link(name, file) {
-  return `- [${name}](./${file})`;
-}
-
-function linkWithMarker(name, file, exists) {
-  const base = link(name, file);
-  return exists ? base : `${base} _(To be generated)_`;
-}
-
-function renderIndex(projectRoot, { projectTypes = [], parts = [], generated = [], existing = [], deepDiveFiles = [] } = {}) {
-  const dir = path.join(projectRoot, '.wize', 'knowledge', 'document-project');
-  fs.mkdirSync(dir, { recursive: true });
-
-  const generatedSet = new Set(generated.map(g => path.basename(g)));
-  const existingSet = new Set(existing.map(e => path.basename(e)));
-  const has = name => generatedSet.has(name) || existingSet.has(name);
-
-  const isMultiPart = parts.length >= 2;
-  const primaryType = projectTypes[0] || 'unknown';
-
-  const lines = [
-    '---',
-    'status: baseline',
-    'owner: Pepper Potts + Peggy Carter',
-    `created: ${new Date().toISOString().slice(0, 10)}`,
-    `last_refreshed: ${new Date().toISOString().slice(0, 10)}`,
-    '---',
-    '',
-    '# Project Documentation Index',
-    '',
-    `**Type:** ${isMultiPart ? 'multi-part' : primaryType}`,
-    `**Primary project type(s):** ${projectTypes.join(', ') || 'unknown'}`,
-    '',
-    '## Generated Documentation',
-    '',
-    link('Project Overview', 'project-overview.md'),
-    linkWithMarker('Source Tree Analysis', 'source-tree-analysis.md', has('source-tree-analysis.md')),
-  ];
-
-  if (isMultiPart) {
-    for (const part of parts) {
-      const suffix = part.part_id === 'root' ? '' : `-${part.part_id}`;
-      lines.push(linkWithMarker(`Architecture — ${part.part_id || 'root'}`, `architecture${suffix}.md`, has(`architecture${suffix}.md`)));
-      lines.push(linkWithMarker(`Development Guide — ${part.part_id || 'root'}`, `development-guide${suffix}.md`, has(`development-guide${suffix}.md`)));
-      lines.push(linkWithMarker(`Component Inventory — ${part.part_id || 'root'}`, `component-inventory${suffix}.md`, has(`component-inventory${suffix}.md`)));
-      lines.push(linkWithMarker(`API Contracts — ${part.part_id || 'root'}`, `api-contracts${suffix}.md`, has(`api-contracts${suffix}.md`)));
-      lines.push(linkWithMarker(`Data Models — ${part.part_id || 'root'}`, `data-models${suffix}.md`, has(`data-models${suffix}.md`)));
-    }
-    lines.push(linkWithMarker('Integration Architecture', 'integration-architecture.md', has('integration-architecture.md')));
-  } else {
-    lines.push(linkWithMarker('Architecture', 'architecture.md', has('architecture.md')));
-    lines.push(linkWithMarker('Development Guide', 'development-guide.md', has('development-guide.md')));
-    lines.push(linkWithMarker('Component Inventory', 'component-inventory.md', has('component-inventory.md')));
-    lines.push(linkWithMarker('API Contracts', 'api-contracts.md', has('api-contracts.md')));
-    lines.push(linkWithMarker('Data Models', 'data-models.md', has('data-models.md')));
-  }
-
-  lines.push(linkWithMarker('Deployment Guide', 'deployment-guide.md', has('deployment-guide.md')));
-  lines.push(linkWithMarker('Contribution Guide', 'contribution-guide.md', has('contribution-guide.md')));
-  if (deepDiveFiles.length) {
-    lines.push('', '## Deep-Dive Docs', '');
-    for (const f of deepDiveFiles) {
-      lines.push(link(f.replace(/^deep-dive-/, '').replace(/\.md$/, ''), f));
-    }
-  } else {
-    lines.push(linkWithMarker('Deep-Dive Docs', 'deep-dive/', false)); // directory marker
-  }
-
-  if (existing.length) {
-    lines.push('', '## Existing Documentation', '');
-    for (const doc of existing) {
-      const rel = path.relative(dir, doc);
-      lines.push(`- [${path.basename(doc)}](./${rel})`);
-    }
-  }
-
-  lines.push('', '## Brownfield Baseline', '');
-  lines.push(link('Overview', 'overview.md'));
-  lines.push(link('Architecture Snapshot', 'architecture-snapshot.md'));
-  lines.push(link('Conventions', 'conventions.md'));
-  lines.push(link('Dependencies', 'dependencies.md'));
-  lines.push(link('Risk Spots', 'risk-spots.md'));
-  lines.push(link('Open Questions', 'open-questions.md'));
-
-  lines.push('', '---', '', '_Generated by `wize-document-project`._', '');
-
-  const file = path.join(dir, 'index.md');
-  fs.writeFileSync(file, lines.join('\n'), 'utf-8');
-  return { changed: true, written: ['index.md'] };
-}
-
-module.exports = { renderIndex, link, linkWithMarker };

package/tools/installer/document-project/state.js

@@ -1,110 +0,0 @@
-// State file management for `wize-dev-kit document-project`.
-//
-// Tracks scan progress so long-running deep/exhaustive scans can resume.
-
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-const WORKFLOW_VERSION = '0.3.1';
-const STATE_FILE = 'project-scan-report.json';
-const ARCHIVE_DIR = '_archive';
-
-function nowIso() {
-  return new Date().toISOString();
-}
-
-function statePath(projectRoot) {
-  return path.join(projectRoot, '.wize', 'knowledge', 'document-project', STATE_FILE);
-}
-
-function archivePath(projectRoot, timestamp) {
-  const dir = path.join(projectRoot, '.wize', 'knowledge', 'document-project', ARCHIVE_DIR);
-  fs.mkdirSync(dir, { recursive: true });
-  const safe = timestamp.replace(/[:.]/g, '-');
-  return path.join(dir, `project-scan-report-${safe}.json`);
-}
-
-function initState(projectRoot, mode, scanLevel) {
-  const state = {
-    workflow_version: WORKFLOW_VERSION,
-    timestamps: { started: nowIso(), last_updated: nowIso() },
-    mode,
-    scan_level: scanLevel,
-    project_root: projectRoot,
-    project_knowledge: path.join(projectRoot, '.wize', 'knowledge', 'document-project'),
-    completed_steps: [],
-    current_step: 'step_1',
-    findings: {},
-    outputs_generated: [STATE_FILE],
-    resume_instructions: `Starting ${mode} (${scanLevel}) from step_1`
-  };
-  writeState(projectRoot, state);
-  return state;
-}
-
-function loadState(projectRoot) {
-  const p = statePath(projectRoot);
-  if (!fs.existsSync(p)) return null;
-  try {
-    const content = fs.readFileSync(p, 'utf-8');
-    const state = JSON.parse(content);
-    if (!state.workflow_version || !state.timestamps || !state.mode || !state.scan_level) {
-      return null;
-    }
-    return state;
-  } catch {
-    return null;
-  }
-}
-
-function writeState(projectRoot, state) {
-  const p = statePath(projectRoot);
-  fs.mkdirSync(path.dirname(p), { recursive: true });
-  state.timestamps.last_updated = nowIso();
-  fs.writeFileSync(p, JSON.stringify(state, null, 2), 'utf-8');
-}
-
-function updateState(projectRoot, patch) {
-  const state = loadState(projectRoot) || initState(projectRoot, 'quick', 'quick');
-  for (const key of Object.keys(patch)) {
-    const val = patch[key];
-    if (Array.isArray(val) && Array.isArray(state[key])) {
-      state[key].push(...val);
-    } else if (typeof val === 'object' && val !== null && !Array.isArray(val)) {
-      state[key] = { ...(state[key] || {}), ...val };
-    } else {
-      state[key] = val;
-    }
-  }
-  writeState(projectRoot, state);
-  return state;
-}
-
-function archiveOldState(projectRoot) {
-  const p = statePath(projectRoot);
-  if (!fs.existsSync(p)) return false;
-  const content = fs.readFileSync(p, 'utf-8');
-  const archived = archivePath(projectRoot, nowIso());
-  fs.writeFileSync(archived, content, 'utf-8');
-  fs.rmSync(p);
-  return true;
-}
-
-function stateAgeDays(state) {
-  if (!state || !state.timestamps || !state.timestamps.last_updated) return null;
-  const then = Date.parse(state.timestamps.last_updated);
-  if (Number.isNaN(then)) return null;
-  return Math.floor((Date.now() - then) / (24 * 3600 * 1000));
-}
-
-module.exports = {
-  statePath,
-  initState,
-  loadState,
-  updateState,
-  archiveOldState,
-  stateAgeDays,
-  WORKFLOW_VERSION
-};

package/tools/installer/version-check.js

@@ -1,117 +0,0 @@
-// Best-effort, non-blocking npm registry check for "is there a newer wize-dev-kit
-// version than the one I'm running?". Designed so the CLI can call it from
-// `list` / `agent list` / `help` and print a single hint at the top, without
-// ever blocking the command if the network is slow, the user is offline, or
-// the registry is misbehaving.
-//
-// Strategy:
-//   - Cache the registry answer in $XDG_CACHE_HOME (or ~/.cache) for 1 hour.
-//   - Resolve via fetch with a 1.5s timeout. Failure is silent.
-//   - Compare with the kit version baked into the running CLI.
-//   - Expose a `printUpdateHintIfAny(currentVersion)` helper for the CLI.
-
-'use strict';
-
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-
-const CACHE_TTL_MS = 60 * 60 * 1000;       // 1h
-const NETWORK_TIMEOUT_MS = 1500;
-
-function cacheFile() {
-  const base = process.env.XDG_CACHE_HOME || path.join(os.homedir(), '.cache');
-  return path.join(base, 'wize-dev-kit', 'registry-version.json');
-}
-
-function readCache() {
-  const f = cacheFile();
-  try {
-    const stat = fs.statSync(f);
-    if (Date.now() - stat.mtimeMs > CACHE_TTL_MS) return null;
-    return JSON.parse(fs.readFileSync(f, 'utf-8'));
-  } catch (_) {
-    return null;
-  }
-}
-
-function writeCache(payload) {
-  const f = cacheFile();
-  try {
-    fs.mkdirSync(path.dirname(f), { recursive: true });
-    fs.writeFileSync(f, JSON.stringify(payload), 'utf-8');
-  } catch (_) { /* cache failure is harmless */ }
-}
-
-async function fetchLatestFromRegistry() {
-  const ctrl = new AbortController();
-  const timer = setTimeout(() => ctrl.abort(), NETWORK_TIMEOUT_MS);
-  try {
-    const res = await fetch('https://registry.npmjs.org/wize-dev-kit', {
-      signal: ctrl.signal,
-      headers: { Accept: 'application/vnd.npm.install-v1+json' }
-    });
-    if (!res.ok) return null;
-    const body = await res.json();
-    const latest = body && body['dist-tags'] && body['dist-tags'].latest;
-    return typeof latest === 'string' ? latest : null;
-  } catch (_) {
-    return null;   // any error → silent fallback
-  } finally {
-    clearTimeout(timer);
-  }
-}
-
-// Returns the registry-latest version, hitting the cache first. Never throws,
-// never blocks meaningfully (network call is capped + abortable).
-async function getLatestVersion({ skipCache = false } = {}) {
-  if (!skipCache) {
-    const c = readCache();
-    if (c && c.version) return c.version;
-  }
-  const fresh = await fetchLatestFromRegistry();
-  if (fresh) writeCache({ version: fresh, fetched_at: Date.now() });
-  return fresh;
-}
-
-function semverGreater(a, b) {
-  const pa = String(a).split('.').map(n => parseInt(n, 10) || 0);
-  const pb = String(b).split('.').map(n => parseInt(n, 10) || 0);
-  for (let i = 0; i < 3; i++) {
-    if ((pa[i] || 0) > (pb[i] || 0)) return true;
-    if ((pa[i] || 0) < (pb[i] || 0)) return false;
-  }
-  return false;
-}
-
-// Prints a one-line hint when a newer version is available. Silent otherwise.
-// Designed to be awaited near the top of a CLI command; if anything is slow
-// or off, it just returns.
-async function printUpdateHintIfAny(currentVersion, { log = console.log, isTTY = process.stdout.isTTY } = {}) {
-  if (process.env.WIZE_DISABLE_UPDATE_CHECK === '1') return;
-  if (!isTTY) return;            // don't spam pipes
-  try {
-    const latest = await getLatestVersion();
-    if (!latest) return;
-    if (semverGreater(latest, currentVersion)) {
-      log('');
-      log(`  ↑ Update available: wize-dev-kit ${currentVersion} → ${latest}`);
-      log(`    Run \`npx wize-dev-kit@latest update\` in your project to refresh adapters.`);
-      log('');
-    }
-  } catch (_) {
-    /* total fallback — never block the command */
-  }
-}
-
-module.exports = {
-  CACHE_TTL_MS,
-  NETWORK_TIMEOUT_MS,
-  cacheFile,
-  readCache,
-  writeCache,
-  fetchLatestFromRegistry,
-  getLatestVersion,
-  semverGreater,
-  printUpdateHintIfAny
-};