@sun-asterisk/sungen 3.2.2 → 3.2.3-beta.3

package/dist/orchestrator/ai-skills/golden-skills.test.js

@@ -0,0 +1,183 @@
+"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 });
+/**
+ * Golden regression net for the single-source generator.
+ *
+ * Compares generated output for all adapters against committed fixtures under
+ * tests/golden/ai-skills/fixtures/. The fixtures were frozen from output that was proven
+ * byte-identical to the original per-assistant templates (see git history: the prior
+ * ai-instructions-based golden). From now on the fixtures ARE the contract — any change to
+ * a source skill/command must be reflected with `--update`, making every output change a
+ * reviewable diff.
+ *
+ *   tsx .../golden-skills.test.ts            # verify
+ *   tsx .../golden-skills.test.ts --update   # re-freeze fixtures after an intentional change
+ *
+ * Also runs source lint (decision 6A): required frontmatter + unique-ish command order,
+ * and a Codex flat-namespace collision check.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const build_1 = require("./build");
+const commands_1 = require("./commands");
+const FIX = path.resolve(__dirname, '..', '..', '..', 'tests', 'golden', 'ai-skills', 'fixtures');
+const SRC = path.resolve(__dirname, '..', 'templates', 'ai-src', 'skills');
+const SRC_CMD = path.resolve(__dirname, '..', 'templates', 'ai-src', 'commands');
+const UPDATE = process.argv.includes('--update');
+function lint() {
+    const errs = [];
+    const fmKeys = (t) => {
+        const s = new Set();
+        if (!t.startsWith('---'))
+            return s;
+        for (const l of t.slice(3, t.indexOf('\n---', 3)).split('\n')) {
+            const m = l.match(/^([a-zA-Z_-]+):/);
+            if (m)
+                s.add(m[1]);
+        }
+        return s;
+    };
+    for (const dir of fs.existsSync(SRC) ? fs.readdirSync(SRC) : []) {
+        const dp = path.join(SRC, dir);
+        if (!fs.statSync(dp).isDirectory())
+            continue;
+        const f = path.join(dp, 'SKILL.md');
+        if (!fs.existsSync(f))
+            continue;
+        const k = fmKeys(fs.readFileSync(f, 'utf8'));
+        if (!k.has('name'))
+            errs.push(`${dir}/SKILL.md: missing frontmatter name`);
+        if (!k.has('description'))
+            errs.push(`${dir}/SKILL.md: missing frontmatter description`);
+    }
+    const seen = new Map();
+    for (const f of fs.existsSync(SRC_CMD) ? fs.readdirSync(SRC_CMD) : []) {
+        const c = (0, commands_1.parseCommandSource)(fs.readFileSync(path.join(SRC_CMD, f), 'utf8'), f.replace(/\.md$/, ''));
+        if (!c.description)
+            errs.push(`commands/${f}: missing description`);
+        if (c.order != null) {
+            const k = String(c.order);
+            if (seen.has(k)) { /* allowed: parallel entrypoints */ }
+            else
+                seen.set(k, f);
+        }
+    }
+    return errs;
+}
+function run() {
+    // Guardrail: the retired per-assistant folder must never come back. Skills are authored
+    // ONCE in ai-src/. If a dev recreates ai-instructions/, fail loud with a pointer.
+    const legacyDir = path.resolve(__dirname, '..', 'templates', 'ai-instructions');
+    if (fs.existsSync(legacyDir)) {
+        console.error('GOLDEN FAILED — templates/ai-instructions/ exists again.');
+        console.error('  Author skills/commands in templates/ai-src/ ONLY (see ai-src/README.md).');
+        console.error('  The per-assistant duplicates are generated from ai-src by ai-skills/build.ts.');
+        process.exit(1);
+    }
+    const lintErrs = lint();
+    // stripCaps throws on unknown cap tag / unclosed fence, so buildOutputs validates fences.
+    const outputs = (0, build_1.buildOutputs)(['claude', 'copilot', 'codex']);
+    // Codex has ONE flat .agents/skills/ namespace — every discovered SKILL.md `name:` must be
+    // unique, or `$name`/description selection is ambiguous (regression guard for the command vs
+    // backing-skill collision: dashboard/delivery/locale must be <name> vs <name>-guide).
+    const codexNames = new Map();
+    for (const f of outputs) {
+        if (!f.outputPath.startsWith('.agents/skills/') || !f.outputPath.endsWith('/SKILL.md'))
+            continue;
+        const m = f.content.match(/^name:\s*(\S+)/m);
+        if (!m)
+            continue;
+        if (codexNames.has(m[1]))
+            lintErrs.push(`codex duplicate skill name "${m[1]}" (${f.outputPath} & ${codexNames.get(m[1])})`);
+        else
+            codexNames.set(m[1], f.outputPath);
+    }
+    if (UPDATE) {
+        fs.rmSync(FIX, { recursive: true, force: true });
+        for (const f of outputs) {
+            const abs = path.join(FIX, f.outputPath);
+            fs.mkdirSync(path.dirname(abs), { recursive: true });
+            fs.writeFileSync(abs, f.content);
+        }
+        console.log(`✓ froze ${outputs.length} fixtures -> tests/golden/ai-skills/fixtures/`);
+        if (lintErrs.length) {
+            console.error('source lint errors:');
+            lintErrs.forEach((e) => console.error('  ✗ ' + e));
+            process.exit(1);
+        }
+        return;
+    }
+    let pass = 0;
+    const mismatches = [];
+    const missing = [];
+    const expectedPaths = new Set(outputs.map((f) => f.outputPath));
+    for (const f of outputs) {
+        const abs = path.join(FIX, f.outputPath);
+        if (!fs.existsSync(abs)) {
+            missing.push(f.outputPath);
+            continue;
+        }
+        if (fs.readFileSync(abs, 'utf8') === f.content)
+            pass++;
+        else
+            mismatches.push(f.outputPath);
+    }
+    // fixtures present but no longer generated => stale
+    const stale = [];
+    const walk = (d, base = '') => {
+        if (!fs.existsSync(d))
+            return;
+        for (const e of fs.readdirSync(d, { withFileTypes: true })) {
+            const rel = path.join(base, e.name);
+            if (e.isDirectory())
+                walk(path.join(d, e.name), rel);
+            else if (!expectedPaths.has(rel))
+                stale.push(rel);
+        }
+    };
+    walk(FIX);
+    console.log(`GOLDEN — source lint: ${lintErrs.length === 0 ? 'PASS' : lintErrs.length + ' error(s)'}`);
+    lintErrs.forEach((e) => console.log('   ✗ ' + e));
+    console.log(`GOLDEN — fixtures: ${pass}/${outputs.length} match | mismatch ${mismatches.length} | missing ${missing.length} | stale ${stale.length}`);
+    [...mismatches.map((m) => 'MISMATCH ' + m), ...missing.map((m) => 'MISSING ' + m), ...stale.map((s) => 'STALE ' + s)].forEach((x) => console.log('   ✗ ' + x));
+    if (lintErrs.length || mismatches.length || missing.length || stale.length) {
+        console.error('GOLDEN FAILED — run with --update if the change was intentional, then review the diff.');
+        process.exit(1);
+    }
+    console.log('✓ GOLDEN PASS — all adapter output matches frozen fixtures.');
+}
+run();
+//# sourceMappingURL=golden-skills.test.js.map

package/dist/orchestrator/ai-skills/golden-skills.test.js.map

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

package/dist/orchestrator/ai-skills/resolve-assistants.d.ts

@@ -0,0 +1,8 @@
+import { AdapterKey } from './adapters';
+/**
+ * Resolve `--assistant` CLI values to adapter keys.
+ * Empty -> ['claude'] (decision T5: never silently install all into a single-assistant repo).
+ * 'all' -> every adapter. Unknown values throw.
+ */
+export declare function resolveAssistants(input: string[] | undefined): AdapterKey[];
+//# sourceMappingURL=resolve-assistants.d.ts.map

package/dist/orchestrator/ai-skills/resolve-assistants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-assistants.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/ai-skills/resolve-assistants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,UAAU,EAAE,CAU3E"}

package/dist/orchestrator/ai-skills/resolve-assistants.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAssistants = resolveAssistants;
+const adapters_1 = require("./adapters");
+/**
+ * Resolve `--assistant` CLI values to adapter keys.
+ * Empty -> ['claude'] (decision T5: never silently install all into a single-assistant repo).
+ * 'all' -> every adapter. Unknown values throw.
+ */
+function resolveAssistants(input) {
+    if (!input || input.length === 0)
+        return ['claude'];
+    const set = new Set();
+    for (const raw of input) {
+        const v = raw.toLowerCase().trim();
+        if (v === 'all') {
+            adapters_1.ALL_ADAPTERS.forEach((a) => set.add(a));
+            continue;
+        }
+        if (v === 'claude' || v === 'copilot' || v === 'codex') {
+            set.add(v);
+            continue;
+        }
+        throw new Error(`Unknown --assistant "${raw}" (valid: claude, copilot, codex, all)`);
+    }
+    return [...set];
+}
+//# sourceMappingURL=resolve-assistants.js.map

package/dist/orchestrator/ai-skills/resolve-assistants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-assistants.js","sourceRoot":"","sources":["../../../src/orchestrator/ai-skills/resolve-assistants.ts"],"names":[],"mappings":";;AAOA,8CAUC;AAjBD,yCAAsD;AAEtD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,KAA2B;IAC3D,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAc,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;YAAC,uBAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QACvE,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;YAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,wCAAwC,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;AAClB,CAAC"}

package/dist/orchestrator/ai-skills/writer.d.ts

@@ -0,0 +1,15 @@
+import { BuiltFile } from './build';
+export interface ApplyOptions {
+    force?: boolean;
+    dryRun?: boolean;
+    version: string;
+}
+export interface ApplyReport {
+    created: string[];
+    overwritten: string[];
+    skippedConfig: string[];
+    deletedOrphans: string[];
+    handEditWarnings: string[];
+}
+export declare function applyOutputs(cwd: string, outputs: BuiltFile[], opts: ApplyOptions): ApplyReport;
+//# sourceMappingURL=writer.d.ts.map

package/dist/orchestrator/ai-skills/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/ai-skills/writer.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,WAAW,YAAY;IAAG,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACpF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IAClE,cAAc,EAAE,MAAM,EAAE,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;CACtD;AAaD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,GAAG,WAAW,CAyD/F"}

package/dist/orchestrator/ai-skills/writer.js

@@ -0,0 +1,129 @@
+"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.applyOutputs = applyOutputs;
+/**
+ * applyOutputs — write a BuiltFile[] to disk with the agreed semantics (decisions 2, T2).
+ *
+ *   managed (skills/commands): ALWAYS overwritten (version-managed, no rollback)
+ *   config  (CLAUDE.md/AGENTS.md/copilot-instructions): skip-if-exists unless `force`
+ *   orphans: managed files written last run but not this run are DELETED (manifest-derived,
+ *            replaces the hand-curated STALE list — decision T2)
+ *   detect-and-warn: if a managed file on disk was hand-edited since we wrote it, warn
+ *   dry-run: report adds/overwrites/skips/deletes/warnings without touching disk
+ *
+ * Manifest: <cwd>/.sungen/manifest.json = { version, managed: { <path>: <sha256> } }
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+const MANIFEST_REL = path.join('.sungen', 'manifest.json');
+const sha = (s) => crypto.createHash('sha256').update(s).digest('hex');
+function readManifest(cwd) {
+    const p = path.join(cwd, MANIFEST_REL);
+    if (!fs.existsSync(p))
+        return { version: '', managed: {} };
+    try {
+        return JSON.parse(fs.readFileSync(p, 'utf8'));
+    }
+    catch {
+        return { version: '', managed: {} };
+    }
+}
+function applyOutputs(cwd, outputs, opts) {
+    const r = { created: [], overwritten: [], skippedConfig: [], deletedOrphans: [], handEditWarnings: [] };
+    const prev = readManifest(cwd);
+    const newManaged = {};
+    const write = (rel, content) => {
+        if (opts.dryRun)
+            return;
+        const abs = path.join(cwd, rel);
+        fs.mkdirSync(path.dirname(abs), { recursive: true });
+        fs.writeFileSync(abs, content, 'utf8');
+    };
+    for (const f of outputs) {
+        const abs = path.join(cwd, f.outputPath);
+        const exists = fs.existsSync(abs);
+        if (f.cls === 'config') {
+            if (exists && !opts.force) {
+                r.skippedConfig.push(f.outputPath);
+                continue;
+            }
+            (exists ? r.overwritten : r.created).push(f.outputPath);
+            write(f.outputPath, f.content);
+            continue;
+        }
+        // managed: always overwrite, but warn if hand-edited since our last write
+        if (exists) {
+            const current = fs.readFileSync(abs, 'utf8');
+            const recorded = prev.managed[f.outputPath];
+            if (recorded && sha(current) !== recorded && sha(current) !== sha(f.content)) {
+                r.handEditWarnings.push(f.outputPath);
+            }
+            if (current !== f.content)
+                r.overwritten.push(f.outputPath);
+        }
+        else {
+            r.created.push(f.outputPath);
+        }
+        write(f.outputPath, f.content);
+        newManaged[f.outputPath] = sha(f.content);
+    }
+    // Orphan cleanup: managed files we wrote last time but not now.
+    for (const oldPath of Object.keys(prev.managed)) {
+        if (newManaged[oldPath])
+            continue;
+        r.deletedOrphans.push(oldPath);
+        if (!opts.dryRun) {
+            const abs = path.join(cwd, oldPath);
+            if (fs.existsSync(abs))
+                fs.rmSync(abs, { force: true });
+            // prune now-empty skill dir
+            const dir = path.dirname(abs);
+            try {
+                if (fs.existsSync(dir) && fs.readdirSync(dir).length === 0)
+                    fs.rmdirSync(dir);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    if (!opts.dryRun) {
+        const mPath = path.join(cwd, MANIFEST_REL);
+        fs.mkdirSync(path.dirname(mPath), { recursive: true });
+        fs.writeFileSync(mPath, JSON.stringify({ version: opts.version, managed: newManaged }, null, 2));
+    }
+    return r;
+}
+//# sourceMappingURL=writer.js.map

package/dist/orchestrator/ai-skills/writer.js.map

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

package/dist/orchestrator/flow-manager.d.ts

@@ -7,6 +7,12 @@ export interface FlowOptions {
     name: string;
     path?: string;
     description?: string;
+    /**
+     * Mobile navigation recipe for the flow's starting screen. A `>`-separated list of nav steps
+     * that take the app from launch to the first screen in the flow. Scaffolded into the Background.
+     * Ignored (with a warning) for web projects.
+     */
+    reach?: string;
 }
 export declare class FlowManager {
     private cwd;
@@ -18,5 +24,10 @@ export declare class FlowManager {
     private generateSpecTemplate;
     private generateViewpointTemplate;
     private generateFeatureTemplate;
+    /**
+     * Build the Background block for a mobile flow — same structure as screen-manager.
+     * The `--reach` steps represent how to reach the FIRST screen of the flow from app launch.
+     */
+    private buildMobileBackground;
 }
 //# sourceMappingURL=flow-manager.d.ts.map

package/dist/orchestrator/flow-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow-manager.d.ts","sourceRoot":"","sources":["../../src/orchestrator/flow-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;;IAOnB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA0FlD,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,oBAAoB;IAiC5B,OAAO,CAAC,yBAAyB;IAmDjC,OAAO,CAAC,uBAAuB;CAyBhC"}
+{"version":3,"file":"flow-manager.d.ts","sourceRoot":"","sources":["../../src/orchestrator/flow-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;;IAOnB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA2HlD,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,oBAAoB;IAiE5B,OAAO,CAAC,yBAAyB;IAmDjC,OAAO,CAAC,uBAAuB;IAkD/B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;CAmC9B"}