@sun-asterisk/sungen 2.7.0-beta.1 → 3.0.0-beta.72

package/dist/harness/sensors.js

@@ -0,0 +1,232 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadCatalog = loadCatalog;
+exports.viewpointGate = viewpointGate;
+exports.assertionDepth = assertionDepth;
+exports.dataThemesFor = dataThemesFor;
+exports.coverageBalance = coverageBalance;
+exports.duplicateClusters = duplicateClusters;
+exports.traceability = traceability;
+/**
+ * Harness Sensors — deterministic quality measurement over test-design artifacts.
+ * Each sensor returns a structured finding the Orchestrator/Repair loop can act on.
+ *
+ * NOTE (honesty): the Viewpoint Gate and Duplicate sensors involve semantics, so
+ * they are HEURISTIC (keyword / skeleton based), not provably exhaustive. They use
+ * a curated seed catalog as the matching reference. See docs/orchestration-spec.md §5.2.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml_1 = require("yaml");
+// Business-critical category codes (project VP-<CAT> prefixes). Configurable later.
+const BUSINESS_CRITICAL_CATS = ['LIST', 'CART', 'PRODUCT', 'FILTER', 'CHECKOUT', 'ORDER'];
+// Buckets for coverage-balance.
+const BUCKETS = {
+    'business-core': BUSINESS_CRITICAL_CATS,
+    'presentation': ['UI'],
+    'validation-security': ['VAL', 'SEC', 'SUB'],
+    'behavior': ['LOGIC'],
+    'navigation': ['NAV'],
+};
+function loadCatalog() {
+    const p = path.join(__dirname, 'catalog', 'universal-viewpoints.yaml');
+    return (0, yaml_1.parse)(fs.readFileSync(p, 'utf-8'));
+}
+const has = (haystacks, kw) => {
+    const k = kw.toLowerCase();
+    return haystacks.some((h) => h.includes(k));
+};
+function viewpointGate(scenarios, viewpoints, catalog) {
+    const haystacks = [
+        ...scenarios.map((s) => s.haystack),
+        ...viewpoints.map((v) => `${v.id} ${v.reason}`.toLowerCase()),
+    ];
+    // Detect page-type by detect_keywords hit count
+    let pageType = null;
+    let best = 0;
+    for (const [pt, def] of Object.entries(catalog.page_types)) {
+        const hits = def.detect_keywords.filter((k) => has(haystacks, k)).length;
+        if (hits > best) {
+            best = hits;
+            pageType = pt;
+        }
+    }
+    const gaps = [];
+    let total = 0, covered = 0;
+    if (pageType) {
+        for (const t of catalog.page_types[pageType].must_cover) {
+            total++;
+            // Scenarios that cover this theme by keyword (include @manual — a manual
+            // scenario with a real assertion still covers the viewpoint for design).
+            const coverers = scenarios.filter((s) => t.keywords.some((k) => s.haystack.includes(k.toLowerCase())));
+            const deep = coverers.some((s) => s.hasDataAssertion);
+            if (deep)
+                covered++;
+            else if (coverers.length > 0)
+                gaps.push({ theme: t.theme, keywords: t.keywords, status: 'shallow' });
+            else
+                gaps.push({ theme: t.theme, keywords: t.keywords, status: 'missing' });
+        }
+    }
+    const universalGaps = catalog.universal
+        .filter((t) => !t.keywords.some((k) => has(scenarios.map((s) => s.haystack), k)))
+        .map((t) => t.theme);
+    return {
+        pageType,
+        themesTotal: total,
+        themesCovered: covered,
+        coverageRatio: total ? covered / total : 1,
+        gaps,
+        universalGaps,
+    };
+}
+// Intent → required depth ratio + whether a miss WARNs (smoke) or FAILs the gate.
+// P3 will read `focus` from qa/context.md; P1 uses 'functional' by default.
+const DEPTH_THRESHOLDS = {
+    functional: 0.7, 'e-commerce': 0.7, security: 0.8, smoke: 0.4,
+};
+const WARN_ONLY_FOCUS = new Set(['smoke']);
+/**
+ * Depth = do DATA-correctness scenarios actually assert DATA (not just visibility)?
+ * "Depth-required" is CATALOG-DRIVEN: only scenarios matching a theme whose
+ * `depth.requires === 'data-assertion'` are measured. Navigation viewpoints
+ * (category NAV) are excluded — landing on a page IS their correct assertion.
+ * This avoids the old keyword-based false-positives (e.g. "API list page").
+ */
+function assertionDepth(scenarios, dataThemes = [], focus = 'functional') {
+    const nonManual = scenarios.filter((s) => !s.manual);
+    const shallow = nonManual.filter((s) => s.shallow);
+    // Precise depth keywords come from each data-theme's depth.keywords (fallback: theme keywords).
+    const depthKeywords = dataThemes.flatMap((t) => (t.depth?.keywords?.length ? t.depth.keywords : t.keywords));
+    // Dismiss/close behaviors ("Continue Shopping closes the modal", "Escape dismisses the
+    // dialog") assert a HIDDEN state — that IS the correct, data-light assertion for the
+    // behavior. They only match a data keyword incidentally (e.g. "added"), so exclude them.
+    const isDismissBehavior = (s) => /\bis hidden\b|\bare hidden\b|\bdismiss|\bdisappear|\bno longer (visible|shown|present|displayed)\b|\bcloses? the (modal|dialog|popup|overlay|panel|menu)\b/.test(s.haystack);
+    const isDepthRequired = (s) => s.category !== 'NAV' && !isDismissBehavior(s) && depthKeywords.some((k) => s.haystack.includes(k.toLowerCase()));
+    const required = nonManual.filter(isDepthRequired);
+    const reqShallow = required.filter((s) => s.shallow);
+    // No data-theme scenarios on this screen → depth is not the binding constraint
+    // (the viewpoint gate already flags missing data themes). Don't double-penalize.
+    const ratio = required.length ? 1 - reqShallow.length / required.length : 1;
+    const threshold = DEPTH_THRESHOLDS[focus] ?? DEPTH_THRESHOLDS.functional;
+    let verdict = 'pass';
+    if (ratio < threshold)
+        verdict = WARN_ONLY_FOCUS.has(focus) ? 'warn' : 'fail';
+    return {
+        total: nonManual.length,
+        shallowTotal: shallow.length,
+        shallowRatio: nonManual.length ? shallow.length / nonManual.length : 0,
+        businessCriticalTotal: required.length,
+        businessCriticalShallow: reqShallow.length,
+        bcDepthRatio: ratio,
+        shallowBusinessCritical: reqShallow.map((s) => ({ name: s.name, category: s.category })),
+        focus,
+        threshold,
+        verdict,
+    };
+}
+/** Collect data-correctness themes (depth.requires) for a page-type + universal. */
+function dataThemesFor(catalog, pageType) {
+    const themes = [];
+    if (pageType && catalog.page_types[pageType])
+        themes.push(...catalog.page_types[pageType].must_cover);
+    themes.push(...catalog.universal);
+    return themes.filter((t) => t.depth?.requires === 'data-assertion');
+}
+function coverageBalance(scenarios) {
+    const byCategory = {};
+    const byBucket = {};
+    for (const b of Object.keys(BUCKETS))
+        byBucket[b] = 0;
+    byBucket['other'] = 0;
+    for (const s of scenarios) {
+        const cat = s.category || 'NONE';
+        byCategory[cat] = (byCategory[cat] || 0) + 1;
+        const bucket = Object.entries(BUCKETS).find(([, cats]) => cats.includes(cat))?.[0] || 'other';
+        byBucket[bucket]++;
+    }
+    const core = byBucket['business-core'];
+    const secondary = byBucket['presentation'] + byBucket['validation-security'];
+    const imbalanced = secondary > core * 1.5 && core > 0;
+    return {
+        byBucket,
+        byCategory,
+        coreCount: core,
+        secondaryCount: secondary,
+        imbalanced,
+        note: imbalanced
+            ? `Secondary viewpoints (presentation+validation/security = ${secondary}) outweigh business-core (${core}) by >1.5x.`
+            : 'Balanced.',
+    };
+}
+function duplicateClusters(scenarios) {
+    const map = new Map();
+    for (const s of scenarios) {
+        const arr = map.get(s.stepSkeleton) || [];
+        arr.push(s);
+        map.set(s.stepSkeleton, arr);
+    }
+    const clusters = [...map.entries()]
+        .filter(([, arr]) => arr.length > 1)
+        .map(([skeleton, arr]) => ({
+        skeleton: skeleton.length > 120 ? skeleton.slice(0, 117) + '...' : skeleton,
+        scenarios: arr.map((s) => s.name),
+        // Same skeleton with data placeholders → likely an EP/data family (intentional), not a true dup.
+        sameDataLikely: !skeleton.includes('{}'),
+    }));
+    return {
+        clusters,
+        exactDuplicateCount: clusters.filter((c) => c.sameDataLikely).reduce((n, c) => n + (c.scenarios.length - 1), 0),
+        sameShapeCount: clusters.reduce((n, c) => n + c.scenarios.length, 0),
+    };
+}
+function traceability(scenarios, viewpoints) {
+    const overviewIds = new Set(viewpoints.map((v) => v.id.toUpperCase()));
+    const withCode = scenarios.filter((s) => s.vpCode);
+    // A scenario maps to overview if its full VP code OR its category-derived id exists in overview.
+    const mapped = withCode.filter((s) => overviewIds.has(s.vpCode) || [...overviewIds].some((id) => id.includes(s.category || '###')));
+    return {
+        total: scenarios.length,
+        withVpCode: withCode.length,
+        mappedToOverview: mapped.length,
+        withVpCodeRatio: scenarios.length ? withCode.length / scenarios.length : 0,
+        mappedRatio: scenarios.length ? mapped.length / scenarios.length : 0,
+        note: mapped.length < withCode.length * 0.5
+            ? 'Scenarios use ad-hoc VP-<CAT>-NNN codes not linked to viewpoint-overview ids (weak traceability — see review Gate 4).'
+            : 'Traceable.',
+    };
+}
+//# sourceMappingURL=sensors.js.map

package/dist/harness/sensors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensors.js","sourceRoot":"","sources":["../../src/harness/sensors.ts"],"names":[],"mappings":"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"}

package/dist/harness/trace.d.ts

@@ -0,0 +1,31 @@
+interface ManualItem {
+    scenario: string;
+    reason: string;
+}
+export interface TraceReport {
+    screen: string;
+    runs: number;
+    ledger: {
+        step: string;
+        ms: number;
+    }[];
+    repairRounds: number;
+    totalMs: number;
+    recordedSteps: string[];
+    missingSteps: string[];
+    audit: {
+        score?: number;
+        gate?: string;
+        weakest?: string;
+        findings?: number;
+        gaps?: string[];
+    } | null;
+    drift: string | null;
+    manual: ManualItem[];
+    bottlenecks: string[];
+    humanFocus: string[];
+    mermaid: string;
+}
+export declare function buildTrace(screenDir: string, screenName: string): TraceReport;
+export {};
+//# sourceMappingURL=trace.d.ts.map

package/dist/harness/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/harness/trace.ts"],"names":[],"mappings":"AAiBA,UAAU,UAAU;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAiCzD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACtG,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAqE7E"}

package/dist/harness/trace.js

@@ -0,0 +1,173 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTrace = buildTrace;
+/**
+ * Trace — visualise the whole executed test-design process and tell the end-user
+ * where to focus human-in-the-loop review.
+ *
+ * Aggregates the artifacts the harness already produces:
+ *   - .sungen/ledger/<name>.jsonl    → what ran, in what order, how many repair loops, time
+ *   - .sungen/reports/<name>-audit.json        → gate result, sub-scores, weak sensor (bottleneck)
+ *   - .sungen/reports/<name>-script-check.json  → Gherkin↔script drift
+ *   - features/<name>.feature                   → @manual scenarios (where humans MUST verify)
+ *
+ * Outputs: a text process map + a Mermaid flowchart (paste into any viewer) +
+ * bottleneck analysis + a ranked "human-loop focus" list.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ledger_1 = require("./ledger");
+function readJson(p) {
+    try {
+        return fs.existsSync(p) ? JSON.parse(fs.readFileSync(p, 'utf-8')) : null;
+    }
+    catch {
+        return null;
+    }
+}
+function readLedger(screen) {
+    const p = path.join(process.cwd(), '.sungen', 'ledger', `${screen}.jsonl`);
+    if (!fs.existsSync(p))
+        return [];
+    return fs.readFileSync(p, 'utf-8').split('\n').filter(Boolean).map((l) => { try {
+        return JSON.parse(l);
+    }
+    catch {
+        return null;
+    } }).filter(Boolean);
+}
+/** Parse @manual scenarios + the explanatory comment line above each. */
+function parseManual(featurePath) {
+    if (!fs.existsSync(featurePath))
+        return [];
+    const lines = fs.readFileSync(featurePath, 'utf-8').split('\n');
+    const out = [];
+    for (let i = 0; i < lines.length; i++) {
+        const m = lines[i].match(/^\s*Scenario:\s*(.+)$/);
+        if (!m)
+            continue;
+        // look back for tag line + a reason comment
+        let manual = false;
+        let reason = '';
+        for (let j = i - 1; j >= 0 && j >= i - 4; j--) {
+            const l = lines[j].trim();
+            if (/^@/.test(l) && /@manual/.test(l))
+                manual = true;
+            else if (/^#/.test(l) && !reason)
+                reason = l.replace(/^#+\s*/, '');
+            else if (l === '' || /^Scenario:/.test(l))
+                break;
+        }
+        if (manual)
+            out.push({ scenario: m[1].trim(), reason: reason || '(no reason noted)' });
+    }
+    return out;
+}
+const EXPECTED_PHASES = ['discovery', 'viewpoint', 'gherkin', 'audit', 'repair'];
+function buildTrace(screenDir, screenName) {
+    const allEvents = readLedger(screenName);
+    const runs = (0, ledger_1.segmentRuns)(allEvents).length;
+    const events = (0, ledger_1.latestRunEvents)(allEvents); // scope to the most recent run (P2)
+    const ledger = events.map((e) => ({ step: e.step, ms: e.ms || 0 }));
+    const repairRounds = new Set(events.filter((e) => /^repair/i.test(e.step)).map((e) => e.step)).size;
+    const totalMs = ledger.reduce((n, e) => n + e.ms, 0);
+    const recordedSteps = [...new Set(ledger.map((e) => e.step.replace(/:\d+$/, '')))];
+    const missingSteps = EXPECTED_PHASES.filter((p) => !recordedSteps.includes(p));
+    const auditRaw = readJson(path.join(process.cwd(), '.sungen', 'reports', `${screenName}-audit.json`));
+    let audit = null;
+    if (auditRaw) {
+        const subs = {
+            coverage: auditRaw.score?.coverage, businessDepth: auditRaw.score?.businessDepth,
+            balance: auditRaw.score?.balance, traceability: auditRaw.score?.traceability,
+        };
+        const weakest = Object.entries(subs).filter(([, v]) => typeof v === 'number').sort((a, b) => a[1] - b[1])[0]?.[0];
+        audit = {
+            score: auditRaw.score?.overall, gate: auditRaw.gateStatus, weakest,
+            findings: (auditRaw.findings || []).length,
+            gaps: (auditRaw.gate?.gaps || []).map((g) => `${g.theme} (${g.status})`),
+        };
+    }
+    const scRaw = readJson(path.join(process.cwd(), '.sungen', 'reports', `${screenName}-script-check.json`));
+    const drift = scRaw ? scRaw.drift : null;
+    const manual = parseManual(path.join(screenDir, 'features', `${screenName}.feature`));
+    // Bottlenecks
+    const bottlenecks = [];
+    if (repairRounds >= 3)
+        bottlenecks.push(`Repair loop hit ${repairRounds} rounds (near/over budget) → first-pass generation (Guide) is the bottleneck.`);
+    if (audit?.weakest)
+        bottlenecks.push(`Lowest audit dimension: ${audit.weakest} → focus engine improvement there.`);
+    if (audit?.gaps?.length)
+        bottlenecks.push(`Gate gaps: ${audit.gaps.join(', ')}.`);
+    if (drift === 'drift')
+        bottlenecks.push('Spec DRIFT vs Gherkin → regenerate (never hand-edit specs).');
+    if (missingSteps.length)
+        bottlenecks.push(`Ledger missing phases: ${missingSteps.join(', ')} → instrument \`sungen ledger record\` at each phase for full observability.`);
+    if (bottlenecks.length === 0)
+        bottlenecks.push('No bottleneck detected from available signals.');
+    // Human-loop focus (where the user must look)
+    const humanFocus = [];
+    if (manual.length)
+        humanFocus.push(`${manual.length} @manual scenario(s) need HUMAN verification (not automated):`);
+    for (const m of manual.slice(0, 12))
+        humanFocus.push(`   • ${m.scenario} — ${m.reason}`);
+    if (audit?.gaps?.length)
+        humanFocus.push(`Critical gaps deferred/uncovered: ${audit.gaps.join(', ')} — decide flow vs accept.`);
+    if (humanFocus.length === 0)
+        humanFocus.push('No manual/uncovered items — automation covers the critical viewpoints.');
+    // Mermaid flowchart of the executed process
+    const phaseSeq = ledger.length
+        ? ledger.map((e) => e.step)
+        : ['(no ledger — process not instrumented)'];
+    const nodes = phaseSeq.map((s, i) => `  S${i}["${s}${ledger[i] ? ` (${ledger[i].ms}ms)` : ''}"]`).join('\n');
+    const edges = phaseSeq.map((_, i) => (i < phaseSeq.length - 1 ? `  S${i} --> S${i + 1}` : '')).filter(Boolean).join('\n');
+    const mermaid = [
+        'flowchart TD',
+        '  IN["spec / figma / ui / live"] --> DISC[discovery]',
+        '  DISC --> VP[viewpoint overview]',
+        '  VP --> GEN[generate Gherkin]',
+        '  GEN --> AUD{sungen audit gate}',
+        repairRounds ? `  AUD -- FAIL --> REP["repair ×${repairRounds}"]` : '',
+        repairRounds ? '  REP --> AUD' : '',
+        `  AUD -- ${audit?.gate === 'PASS' ? 'PASS' : 'still failing'} --> DONE[converge]`,
+        '  DONE --> SC{script-check 1:1}',
+        `  SC -- ${drift === 'drift' ? 'DRIFT → regenerate' : 'in-sync'} --> OUT[generate → run-test → delivery]`,
+    ].filter(Boolean).join('\n');
+    return {
+        screen: screenName, runs, ledger, repairRounds, totalMs, recordedSteps, missingSteps,
+        audit, drift, manual, bottlenecks, humanFocus, mermaid,
+    };
+}
+//# sourceMappingURL=trace.js.map

package/dist/harness/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/harness/trace.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/ai-rules-updater.d.ts

@@ -4,6 +4,7 @@
  * Used by `sungen update` command.
  */
 export declare const AI_RULES_FILE_MAPPING: [string, string][];
+export declare const STALE_AI_RULES_PATHS: string[];
 export declare class AIRulesUpdater {
     private cwd;
     private aiTemplateDir;

package/dist/orchestrator/ai-rules-updater.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-rules-updater.d.ts","sourceRoot":"","sources":["../../src/orchestrator/ai-rules-updater.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,eAAO,MAAM,qBAAqB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAuEnD,CAAC;AAEF,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,aAAa,CAAS;gBAElB,GAAG,EAAE,MAAM;IAKjB,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAwF7C"}
+{"version":3,"file":"ai-rules-updater.d.ts","sourceRoot":"","sources":["../../src/orchestrator/ai-rules-updater.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,eAAO,MAAM,qBAAqB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAmFnD,CAAC;AAKF,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAUxC,CAAC;AAEF,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,aAAa,CAAS;gBAElB,GAAG,EAAE,MAAM;IAKjB,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CA4G7C"}

package/dist/orchestrator/ai-rules-updater.js

@@ -38,7 +38,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AIRulesUpdater = exports.AI_RULES_FILE_MAPPING = void 0;
+exports.AIRulesUpdater = exports.STALE_AI_RULES_PATHS = exports.AI_RULES_FILE_MAPPING = void 0;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 // File mapping: [templateFile, outputPath]
@@ -51,20 +51,24 @@ exports.AI_RULES_FILE_MAPPING = [
     ['claude-cmd-add-screen.md', '.claude/commands/sungen/add-screen.md'],
     ['claude-cmd-add-flow.md', '.claude/commands/sungen/add-flow.md'],
     ['claude-cmd-create-test.md', '.claude/commands/sungen/create-test.md'],
+    ['claude-cmd-design.md', '.claude/commands/sungen/design.md'],
     ['claude-cmd-run-test.md', '.claude/commands/sungen/run-test.md'],
     ['claude-cmd-review.md', '.claude/commands/sungen/review.md'],
     ['claude-cmd-delivery.md', '.claude/commands/sungen/delivery.md'],
     ['claude-cmd-dashboard.md', '.claude/commands/sungen/dashboard.md'],
     ['claude-cmd-locale.md', '.claude/commands/sungen/locale.md'],
+    ['claude-cmd-feedback.md', '.claude/commands/sungen/feedback.md'],
     // Commands — GitHub Copilot
     ['copilot-cmd-add-screen.md', '.github/prompts/sungen-add-screen.prompt.md'],
     ['copilot-cmd-add-flow.md', '.github/prompts/sungen-add-flow.prompt.md'],
     ['copilot-cmd-create-test.md', '.github/prompts/sungen-create-test.prompt.md'],
+    ['copilot-cmd-design.md', '.github/prompts/sungen-design.prompt.md'],
     ['copilot-cmd-run-test.md', '.github/prompts/sungen-run-test.prompt.md'],
     ['copilot-cmd-review.md', '.github/prompts/sungen-review.prompt.md'],
     ['copilot-cmd-delivery.md', '.github/prompts/sungen-delivery.prompt.md'],
     ['copilot-cmd-dashboard.md', '.github/prompts/sungen-dashboard.prompt.md'],
     ['copilot-cmd-locale.md', '.github/prompts/sungen-locale.prompt.md'],
+    ['copilot-cmd-feedback.md', '.github/prompts/sungen-feedback.prompt.md'],
     // Skills — Claude Code
     ['claude-skill-gherkin-syntax.md', '.claude/skills/sungen-gherkin-syntax/SKILL.md'],
     ['claude-skill-selector-keys.md', '.claude/skills/sungen-selector-keys/SKILL.md'],
@@ -73,6 +77,7 @@ exports.AI_RULES_FILE_MAPPING = [
     ['claude-skill-test-design-techniques.md', '.claude/skills/sungen-test-design-techniques/SKILL.md'],
     ['claude-skill-selector-fix.md', '.claude/skills/sungen-selector-fix/SKILL.md'],
     ['claude-skill-tc-review.md', '.claude/skills/sungen-tc-review/SKILL.md'],
+    ['claude-skill-harness-audit.md', '.claude/skills/sungen-harness-audit/SKILL.md'],
     ['claude-skill-viewpoint.md', '.claude/skills/sungen-viewpoint/SKILL.md'],
     ['claude-skill-viewpoint-group-a-data-entry.md', '.claude/skills/sungen-viewpoint/group-a-data-entry.md'],
     ['claude-skill-viewpoint-group-b-data-ops.md', '.claude/skills/sungen-viewpoint/group-b-data-ops.md'],
@@ -81,13 +86,18 @@ exports.AI_RULES_FILE_MAPPING = [
     ['claude-skill-viewpoint-group-e-identity.md', '.claude/skills/sungen-viewpoint/group-e-identity.md'],
     ['claude-skill-delivery.md', '.claude/skills/sungen-delivery/SKILL.md'],
     ['claude-skill-dashboard.md', '.claude/skills/sungen-dashboard/SKILL.md'],
-    ['claude-skill-capture-figma.md', '.claude/skills/sungen-capture-figma/SKILL.md'],
-    ['claude-skill-capture-local.md', '.claude/skills/sungen-capture-local/SKILL.md'],
-    ['claude-skill-capture-live.md', '.claude/skills/sungen-capture-live/SKILL.md'],
-    ['claude-skill-figma-source.md', '.claude/skills/sungen-figma-source/SKILL.md'],
+    // sungen-capture — router skill (1 SKILL.md + 4 mode files). Replaces the former
+    // capture-figma / capture-live / capture-local / figma-source standalone skills.
+    ['claude-skill-capture.md', '.claude/skills/sungen-capture/SKILL.md'],
+    ['claude-skill-capture-mode-figma-mcp.md', '.claude/skills/sungen-capture/mode-figma-mcp.md'],
+    ['claude-skill-capture-mode-figma-pat.md', '.claude/skills/sungen-capture/mode-figma-pat.md'],
+    ['claude-skill-capture-mode-live.md', '.claude/skills/sungen-capture/mode-live.md'],
+    ['claude-skill-capture-mode-local.md', '.claude/skills/sungen-capture/mode-local.md'],
     ['claude-skill-locale.md', '.claude/skills/sungen-locale/SKILL.md'],
-    // Skills — Copilot (prompt-based)
-    ['copilot-skill-figma-source.md', '.github/prompts/sungen-figma-source.prompt.md'],
+    // Agents — Claude Code sub-agents (isolated context). Copilot runs these inline.
+    ['claude-agent-reviewer.md', '.claude/agents/sungen-reviewer.md'],
+    ['claude-agent-discovery.md', '.claude/agents/sungen-discovery.md'],
+    ['claude-agent-challenge.md', '.claude/agents/sungen-challenge.md'],
     // Skills — GitHub Copilot
     ['github-skill-sungen-gherkin-syntax.md', '.github/skills/sungen-gherkin-syntax/SKILL.md'],
     ['github-skill-sungen-selector-keys.md', '.github/skills/sungen-selector-keys/SKILL.md'],
@@ -96,6 +106,7 @@ exports.AI_RULES_FILE_MAPPING = [
     ['github-skill-sungen-test-design-techniques.md', '.github/skills/sungen-test-design-techniques/SKILL.md'],
     ['github-skill-sungen-selector-fix.md', '.github/skills/sungen-selector-fix/SKILL.md'],
     ['github-skill-sungen-tc-review.md', '.github/skills/sungen-tc-review/SKILL.md'],
+    ['github-skill-sungen-harness-audit.md', '.github/skills/sungen-harness-audit/SKILL.md'],
     ['github-skill-sungen-viewpoint.md', '.github/skills/sungen-viewpoint/SKILL.md'],
     ['github-skill-sungen-viewpoint-group-a-data-entry.md', '.github/skills/sungen-viewpoint/group-a-data-entry.md'],
     ['github-skill-sungen-viewpoint-group-b-data-ops.md', '.github/skills/sungen-viewpoint/group-b-data-ops.md'],
@@ -104,12 +115,27 @@ exports.AI_RULES_FILE_MAPPING = [
     ['github-skill-sungen-viewpoint-group-e-identity.md', '.github/skills/sungen-viewpoint/group-e-identity.md'],
     ['github-skill-sungen-delivery.md', '.github/skills/sungen-delivery/SKILL.md'],
     ['github-skill-sungen-dashboard.md', '.github/skills/sungen-dashboard/SKILL.md'],
-    ['github-skill-sungen-capture-figma.md', '.github/skills/sungen-capture-figma/SKILL.md'],
-    ['github-skill-sungen-capture-local.md', '.github/skills/sungen-capture-local/SKILL.md'],
-    ['github-skill-sungen-capture-live.md', '.github/skills/sungen-capture-live/SKILL.md'],
-    ['github-skill-sungen-figma-source.md', '.github/skills/sungen-figma-source/SKILL.md'],
+    ['github-skill-sungen-capture.md', '.github/skills/sungen-capture/SKILL.md'],
+    ['github-skill-sungen-capture-mode-figma-mcp.md', '.github/skills/sungen-capture/mode-figma-mcp.md'],
+    ['github-skill-sungen-capture-mode-figma-pat.md', '.github/skills/sungen-capture/mode-figma-pat.md'],
+    ['github-skill-sungen-capture-mode-live.md', '.github/skills/sungen-capture/mode-live.md'],
+    ['github-skill-sungen-capture-mode-local.md', '.github/skills/sungen-capture/mode-local.md'],
     ['github-skill-sungen-locale.md', '.github/skills/sungen-locale/SKILL.md'],
 ];
+// Skill/asset directories retired in a previous refactor. `sungen update` removes
+// these so already-initialized projects don't keep loading stale skill descriptions.
+// (v3.0: the four capture/figma skills were merged into the `sungen-capture` router.)
+exports.STALE_AI_RULES_PATHS = [
+    '.claude/skills/sungen-capture-figma',
+    '.claude/skills/sungen-capture-live',
+    '.claude/skills/sungen-capture-local',
+    '.claude/skills/sungen-figma-source',
+    '.github/skills/sungen-capture-figma',
+    '.github/skills/sungen-capture-live',
+    '.github/skills/sungen-capture-local',
+    '.github/skills/sungen-figma-source',
+    '.github/prompts/sungen-figma-source.prompt.md',
+];
 class AIRulesUpdater {
     constructor(cwd) {
         this.cwd = cwd;
@@ -151,10 +177,28 @@ class AIRulesUpdater {
                 created.push(outputRelPath);
             }
         }
+        // Remove retired skills/assets so stale descriptions stop loading.
+        const removed = [];
+        for (const staleRelPath of exports.STALE_AI_RULES_PATHS) {
+            const stalePath = path.join(this.cwd, staleRelPath);
+            if (fs.existsSync(stalePath)) {
+                if (!dryRun) {
+                    fs.rmSync(stalePath, { recursive: true, force: true });
+                }
+                removed.push(staleRelPath);
+            }
+        }
         // Print results
         if (dryRun) {
             console.log('📋 Dry run — no files changed\n');
         }
+        if (removed.length > 0) {
+            console.log(`🗑️  Removed retired assets (${removed.length}):`);
+            for (const f of removed) {
+                console.log(`   ${f}`);
+            }
+            console.log();
+        }
         if (updated.length > 0) {
             console.log(`✏️  Updated (${updated.length}):`);
             for (const f of updated) {