@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/project/project-store.js

@@ -1,422 +1 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, copyFileSync, statSync, appendFileSync, } from "fs";
-import { dirname, join } from "path";
-import { getWowMcpDir } from "@wowok/wowok";
-export const CURRENT_SCHEMA_VERSION = "1.0.0";
-export function projectsRootDir() {
-    return join(getWowMcpDir(), "projects");
-}
-export function projectDir(prefix, version) {
-    return join(projectsRootDir(), `${prefix}_${version}`);
-}
-export function deploymentDir(prefix, version) {
-    return join(projectDir(prefix, version), "deployment");
-}
-function manifestPath(prefix, version) {
-    return join(projectDir(prefix, version), "manifest.json");
-}
-function stageStatePath(prefix, version) {
-    return join(projectDir(prefix, version), "stage.json");
-}
-function auditLogPath(prefix, version) {
-    return join(projectDir(prefix, version), "audit.jsonl");
-}
-export function ensureProjectDir(prefix, version) {
-    const dir = projectDir(prefix, version);
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-    return dir;
-}
-export function initProject(prefix, version, options = {}) {
-    ensureProjectDir(prefix, version);
-    const now = new Date().toISOString();
-    const manifest = {
-        schema_version: CURRENT_SCHEMA_VERSION,
-        mcp_version: options.mcpVersion ?? "unknown",
-        prefix,
-        version,
-        created_at: now,
-        updated_at: now,
-        forked_from: options.forkedFrom,
-    };
-    writeFileSync(manifestPath(prefix, version), JSON.stringify(manifest, null, 2), "utf-8");
-    const stageState = {
-        stage: 1,
-        updated_at: Date.now(),
-        stage_meta: {
-            1: { committed: false, gate_passed: false, blocking_issues: [], completion: 0 },
-            2: { committed: false, gate_passed: false, blocking_issues: [], completion: 0 },
-            3: { committed: false, gate_passed: false, blocking_issues: [], completion: 0 },
-            4: { committed: false, gate_passed: false, blocking_issues: [], completion: 0 },
-            5: { committed: false, gate_passed: false, blocking_issues: [], completion: 0 },
-        },
-        has_published_object: false,
-        archived: false,
-    };
-    saveStageState(prefix, version, stageState);
-    appendAudit(prefix, version, {
-        timestamp: now,
-        event: "stage_commit",
-        stage: 1,
-        reason: `project initialized${options.forkedFrom ? ` (forked from ${options.forkedFrom})` : ""}`,
-        affected_files: ["manifest.json", "stage.json"],
-    });
-    return manifest;
-}
-export function loadManifest(prefix, version) {
-    const p = manifestPath(prefix, version);
-    if (!existsSync(p)) {
-        throw new Error(`project not initialized: ${prefix}_${version} (missing manifest.json)`);
-    }
-    const raw = readFileSync(p, "utf-8");
-    return JSON.parse(raw);
-}
-export function saveManifest(prefix, version, manifest) {
-    manifest.updated_at = new Date().toISOString();
-    writeFileSync(manifestPath(prefix, version), JSON.stringify(manifest, null, 2), "utf-8");
-}
-export function loadStageState(prefix, version) {
-    const p = stageStatePath(prefix, version);
-    if (!existsSync(p))
-        return undefined;
-    const raw = readFileSync(p, "utf-8");
-    return JSON.parse(raw);
-}
-export function saveStageState(prefix, version, state) {
-    state.updated_at = Date.now();
-    ensureProjectDir(prefix, version);
-    writeFileSync(stageStatePath(prefix, version), JSON.stringify(state, null, 2), "utf-8");
-}
-export function saveProjectFile(prefix, version, relPath, data) {
-    const abs = join(projectDir(prefix, version), relPath);
-    mkdirSync(dirname(abs), { recursive: true });
-    writeFileSync(abs, JSON.stringify(data, null, 2), "utf-8");
-    return abs;
-}
-export function loadProjectFile(prefix, version, relPath) {
-    const abs = join(projectDir(prefix, version), relPath);
-    if (!existsSync(abs))
-        return undefined;
-    const raw = readFileSync(abs, "utf-8");
-    return JSON.parse(raw);
-}
-export function saveProjectMarkdown(prefix, version, relPath, markdown) {
-    const abs = join(projectDir(prefix, version), relPath);
-    mkdirSync(dirname(abs), { recursive: true });
-    writeFileSync(abs, markdown, "utf-8");
-    return abs;
-}
-export function appendJsonl(prefix, version, relPath, record) {
-    const abs = join(projectDir(prefix, version), relPath);
-    ensureProjectDir(prefix, version);
-    mkdirSync(dirname(abs), { recursive: true });
-    appendFileSync(abs, JSON.stringify(record) + "\n", "utf-8");
-    return abs;
-}
-export function appendAudit(prefix, version, record) {
-    appendJsonl(prefix, version, "audit.jsonl", record);
-}
-export function readAuditLog(prefix, version) {
-    const abs = auditLogPath(prefix, version);
-    if (!existsSync(abs))
-        return [];
-    const raw = readFileSync(abs, "utf-8");
-    return raw
-        .split("\n")
-        .filter((l) => l.trim().length > 0)
-        .map((l) => JSON.parse(l));
-}
-export function parseProjectDirName(dirName) {
-    const m = dirName.match(/^(.+)_v(\d+)$/);
-    if (!m)
-        return undefined;
-    return { prefix: m[1], version: `v${m[2]}` };
-}
-export function listLocalProjects() {
-    const root = projectsRootDir();
-    if (!existsSync(root))
-        return [];
-    const entries = readdirSync(root, { withFileTypes: true });
-    const out = [];
-    for (const e of entries) {
-        if (!e.isDirectory())
-            continue;
-        const parsed = parseProjectDirName(e.name);
-        if (!parsed)
-            continue;
-        const fullPath = join(root, e.name);
-        const manifestFile = join(fullPath, "manifest.json");
-        const stageFile = join(fullPath, "stage.json");
-        let initialized = false;
-        let archived = false;
-        let needsMigration = false;
-        let forkedFrom;
-        if (existsSync(manifestFile)) {
-            initialized = true;
-            try {
-                const m = JSON.parse(readFileSync(manifestFile, "utf-8"));
-                needsMigration = m.schema_version !== CURRENT_SCHEMA_VERSION;
-                forkedFrom = m.forked_from;
-            }
-            catch {
-            }
-        }
-        if (existsSync(stageFile)) {
-            try {
-                const s = JSON.parse(readFileSync(stageFile, "utf-8"));
-                archived = s.archived;
-            }
-            catch {
-            }
-        }
-        let mtime = 0;
-        try {
-            mtime = statSync(fullPath).mtimeMs;
-        }
-        catch {
-        }
-        out.push({
-            dir_name: e.name,
-            prefix: parsed.prefix,
-            version: parsed.version,
-            path: fullPath,
-            initialized,
-            archived,
-            needs_migration: needsMigration,
-            forked_from: forkedFrom,
-            mtime,
-        });
-    }
-    return out.sort((a, b) => b.mtime - a.mtime);
-}
-export function projectExists(prefix, version) {
-    return existsSync(manifestPath(prefix, version));
-}
-export function forkProject(srcPrefix, srcVersion, opts) {
-    if (!projectExists(srcPrefix, srcVersion)) {
-        throw new Error(`source project not found: ${srcPrefix}_${srcVersion}`);
-    }
-    const newPrefix = opts.newPrefix ?? srcPrefix;
-    if (opts.newVersion === srcVersion && newPrefix === srcPrefix) {
-        throw new Error("fork target must differ from source (set newVersion or newPrefix)");
-    }
-    ensureProjectDir(newPrefix, opts.newVersion);
-    const srcDir = projectDir(srcPrefix, srcVersion);
-    const dstDir = projectDir(newPrefix, opts.newVersion);
-    const copiedFiles = [];
-    function walkDir(relBase) {
-        const absBase = join(srcDir, relBase);
-        if (!existsSync(absBase))
-            return;
-        const items = readdirSync(absBase, { withFileTypes: true });
-        for (const item of items) {
-            const rel = relBase ? join(relBase, item.name) : item.name;
-            const srcAbs = join(srcDir, rel);
-            const dstAbs = join(dstDir, rel);
-            if (item.isDirectory()) {
-                mkdirSync(dstAbs, { recursive: true });
-                walkDir(rel);
-            }
-            else if (item.isFile()) {
-                if (rel === "stage.json" || rel === "audit.jsonl")
-                    continue;
-                mkdirSync(dirname(dstAbs), { recursive: true });
-                copyFileSync(srcAbs, dstAbs);
-                copiedFiles.push(rel);
-            }
-        }
-    }
-    walkDir("");
-    const now = new Date().toISOString();
-    const manifest = {
-        schema_version: CURRENT_SCHEMA_VERSION,
-        mcp_version: opts.mcpVersion ?? "unknown",
-        prefix: newPrefix,
-        version: opts.newVersion,
-        created_at: now,
-        updated_at: now,
-        forked_from: srcDir,
-    };
-    writeFileSync(manifestPath(newPrefix, opts.newVersion), JSON.stringify(manifest, null, 2), "utf-8");
-    const stageState = {
-        stage: 1,
-        updated_at: Date.now(),
-        stage_meta: {
-            1: { committed: false, gate_passed: false, blocking_issues: [], completion: 0 },
-            2: { committed: false, gate_passed: false, blocking_issues: [], completion: 0 },
-            3: { committed: false, gate_passed: false, blocking_issues: [], completion: 0 },
-            4: { committed: false, gate_passed: false, blocking_issues: [], completion: 0 },
-            5: { committed: false, gate_passed: false, blocking_issues: [], completion: 0 },
-        },
-        has_published_object: false,
-        archived: false,
-    };
-    saveStageState(newPrefix, opts.newVersion, stageState);
-    appendAudit(newPrefix, opts.newVersion, {
-        timestamp: now,
-        event: "fork_created",
-        reason: `forked from ${srcPrefix}_${srcVersion}; objects must be re-created (project isolation §3.0)`,
-        affected_files: ["manifest.json", "stage.json"],
-    });
-    const srcStage = loadStageState(srcPrefix, srcVersion);
-    if (srcStage) {
-        srcStage.archived = true;
-        saveStageState(srcPrefix, srcVersion, srcStage);
-        appendAudit(srcPrefix, srcVersion, {
-            timestamp: now,
-            event: "stage_commit",
-            reason: `archived after fork to ${newPrefix}_${opts.newVersion}`,
-            affected_files: ["stage.json"],
-        });
-    }
-    return {
-        new_prefix: newPrefix,
-        new_version: opts.newVersion,
-        new_path: dstDir,
-        forked_from: srcDir,
-        copied_files: copiedFiles,
-    };
-}
-export function listProjectFiles(prefix, version) {
-    const dir = projectDir(prefix, version);
-    if (!existsSync(dir))
-        return [];
-    const out = [];
-    function walk(relBase) {
-        const absBase = join(dir, relBase);
-        const items = readdirSync(absBase, { withFileTypes: true });
-        for (const item of items) {
-            const rel = relBase ? join(relBase, item.name) : item.name;
-            const abs = join(dir, rel);
-            if (item.isDirectory()) {
-                walk(rel);
-            }
-            else if (item.isFile()) {
-                let stat;
-                try {
-                    stat = statSync(abs);
-                }
-                catch {
-                    continue;
-                }
-                let kind = "other";
-                if (abs.endsWith(".json"))
-                    kind = "json";
-                else if (abs.endsWith(".md"))
-                    kind = "markdown";
-                else if (abs.endsWith(".jsonl"))
-                    kind = "jsonl";
-                out.push({
-                    path: rel,
-                    abs_path: abs,
-                    size: stat.size,
-                    mtime: stat.mtimeMs,
-                    kind,
-                });
-            }
-        }
-    }
-    walk("");
-    return out.sort((a, b) => a.path.localeCompare(b.path));
-}
-export function readProjectFile(prefix, version, relPath) {
-    const abs = join(projectDir(prefix, version), relPath);
-    if (!existsSync(abs))
-        return undefined;
-    return readFileSync(abs, "utf-8");
-}
-export function commitStage(prefix, version, stage, options = {}) {
-    const state = loadStageState(prefix, version);
-    if (!state) {
-        throw new Error(`project not initialized: ${prefix}_${version}`);
-    }
-    const gatePassed = options.gatePassed ?? false;
-    state.stage_meta[stage] = {
-        committed: true,
-        committed_at: Date.now(),
-        gate_passed: gatePassed,
-        blocking_issues: options.blockingIssues ?? [],
-        completion: options.completion ?? (gatePassed ? 100 : 0),
-    };
-    if (stage < 5 && gatePassed) {
-        state.stage = (stage + 1);
-    }
-    saveStageState(prefix, version, state);
-    appendAudit(prefix, version, {
-        timestamp: new Date().toISOString(),
-        event: "stage_commit",
-        stage,
-        reason: options.reason ?? `stage ${stage} committed`,
-        affected_files: ["stage.json"],
-        user_confirmed: options.userConfirmed,
-    });
-    return state;
-}
-export function rollbackStage(prefix, version, toStage, options = {}) {
-    const state = loadStageState(prefix, version);
-    if (!state) {
-        throw new Error(`project not initialized: ${prefix}_${version}`);
-    }
-    if (state.has_published_object) {
-        throw new Error(`cannot rollback: project has published objects — must fork new version (§3.3)`);
-    }
-    const oldStage = state.stage;
-    for (let s = toStage + 1; s <= 5; s++) {
-        state.stage_meta[s] = {
-            committed: false,
-            gate_passed: false,
-            blocking_issues: [],
-            completion: 0,
-        };
-    }
-    state.stage = toStage;
-    saveStageState(prefix, version, state);
-    appendAudit(prefix, version, {
-        timestamp: new Date().toISOString(),
-        event: "stage_rollback",
-        stage: toStage,
-        reason: options.reason ?? `rollback from stage ${oldStage} to ${toStage}`,
-        affected_files: options.affectedFiles ?? ["stage.json"],
-    });
-    return state;
-}
-export function markObjectPublished(prefix, version, objectName) {
-    const state = loadStageState(prefix, version);
-    if (!state)
-        return;
-    if (state.has_published_object)
-        return;
-    state.has_published_object = true;
-    saveStageState(prefix, version, state);
-    appendAudit(prefix, version, {
-        timestamp: new Date().toISOString(),
-        event: "object_published",
-        stage: 5,
-        reason: `object published: ${objectName} — rollback now requires fork (§3.3)`,
-        affected_files: ["stage.json"],
-    });
-}
-export function getLocalSyncStatus(prefix, version) {
-    const exists = projectExists(prefix, version);
-    if (!exists) {
-        return { local_exists: false, initialized: false, needs_migration: false, archived: false };
-    }
-    let initialized = true;
-    let needsMigration = false;
-    let archived = false;
-    try {
-        const m = loadManifest(prefix, version);
-        needsMigration = m.schema_version !== CURRENT_SCHEMA_VERSION;
-    }
-    catch {
-        initialized = false;
-    }
-    try {
-        const s = loadStageState(prefix, version);
-        if (s)
-            archived = s.archived;
-    }
-    catch {
-    }
-    return { local_exists: true, initialized, needs_migration: needsMigration, archived };
-}
+import{existsSync,mkdirSync,readFileSync,writeFileSync,readdirSync,copyFileSync,statSync,appendFileSync}from'fs';import{dirname,join}from'path';import{getWowMcpDir}from'@wowok/wowok';export const CURRENT_SCHEMA_VERSION='1.0.0';export function projectsRootDir(){return join(getWowMcpDir(),'projects');}export function projectDir(a,b){return join(projectsRootDir(),a+'_'+b);}export function deploymentDir(a,b){return join(projectDir(a,b),'deployment');}function manifestPath(a,b){return join(projectDir(a,b),'manifest.json');}function stageStatePath(a,b){return join(projectDir(a,b),'stage.json');}function auditLogPath(a,b){return join(projectDir(a,b),'audit.jsonl');}export function ensureProjectDir(a,b){const c=projectDir(a,b);return!existsSync(c)&&mkdirSync(c,{'recursive':!![]}),c;}export function initProject(a,b,c={}){ensureProjectDir(a,b);const d=new Date()['toISOString'](),e={'schema_version':CURRENT_SCHEMA_VERSION,'mcp_version':c['mcpVersion']??'unknown','prefix':a,'version':b,'created_at':d,'updated_at':d,'forked_from':c['forkedFrom']};writeFileSync(manifestPath(a,b),JSON['stringify'](e,null,0x2),'utf-8');const f={'stage':0x1,'updated_at':Date['now'](),'stage_meta':{0x1:{'committed':![],'gate_passed':![],'blocking_issues':[],'completion':0x0},0x2:{'committed':![],'gate_passed':![],'blocking_issues':[],'completion':0x0},0x3:{'committed':![],'gate_passed':![],'blocking_issues':[],'completion':0x0},0x4:{'committed':![],'gate_passed':![],'blocking_issues':[],'completion':0x0},0x5:{'committed':![],'gate_passed':![],'blocking_issues':[],'completion':0x0}},'has_published_object':![],'archived':![]};return saveStageState(a,b,f),appendAudit(a,b,{'timestamp':d,'event':'stage_commit','stage':0x1,'reason':'project\x20initialized'+(c['forkedFrom']?'\x20(forked\x20from\x20'+c['forkedFrom']+')':''),'affected_files':['manifest.json','stage.json']}),e;}export function loadManifest(a,b){const c=manifestPath(a,b);if(!existsSync(c))throw new Error('project\x20not\x20initialized:\x20'+a+'_'+b+'\x20(missing\x20manifest.json)');const d=readFileSync(c,'utf-8');return JSON['parse'](d);}export function saveManifest(a,b,c){c['updated_at']=new Date()['toISOString'](),writeFileSync(manifestPath(a,b),JSON['stringify'](c,null,0x2),'utf-8');}export function loadStageState(a,b){const c=stageStatePath(a,b);if(!existsSync(c))return undefined;const d=readFileSync(c,'utf-8');return JSON['parse'](d);}export function saveStageState(a,b,c){c['updated_at']=Date['now'](),ensureProjectDir(a,b),writeFileSync(stageStatePath(a,b),JSON['stringify'](c,null,0x2),'utf-8');}export function saveProjectFile(a,b,c,d){const e=join(projectDir(a,b),c);return mkdirSync(dirname(e),{'recursive':!![]}),writeFileSync(e,JSON['stringify'](d,null,0x2),'utf-8'),e;}export function loadProjectFile(a,b,c){const d=join(projectDir(a,b),c);if(!existsSync(d))return undefined;const e=readFileSync(d,'utf-8');return JSON['parse'](e);}export function saveProjectMarkdown(a,b,c,d){const e=join(projectDir(a,b),c);return mkdirSync(dirname(e),{'recursive':!![]}),writeFileSync(e,d,'utf-8'),e;}export function appendJsonl(a,b,c,d){const e=join(projectDir(a,b),c);return ensureProjectDir(a,b),mkdirSync(dirname(e),{'recursive':!![]}),appendFileSync(e,JSON['stringify'](d)+'\x0a','utf-8'),e;}export function appendAudit(a,b,c){appendJsonl(a,b,'audit.jsonl',c);}export function readAuditLog(a,b){const c=auditLogPath(a,b);if(!existsSync(c))return[];const d=readFileSync(c,'utf-8');return d['split']('\x0a')['filter'](e=>e['trim']()['length']>0x0)['map'](e=>JSON['parse'](e));}export function parseProjectDirName(a){const b=a['match'](/^(.+)_v(\d+)$/);if(!b)return undefined;return{'prefix':b[0x1],'version':'v'+b[0x2]};}export function listLocalProjects(){const a=projectsRootDir();if(!existsSync(a))return[];const b=readdirSync(a,{'withFileTypes':!![]}),c=[];for(const d of b){if(!d['isDirectory']())continue;const f=parseProjectDirName(d['name']);if(!f)continue;const g=join(a,d['name']),h=join(g,'manifest.json'),i=join(g,'stage.json');let j=![],k=![],l=![],n;if(existsSync(h)){j=!![];try{const p=JSON['parse'](readFileSync(h,'utf-8'));l=p['schema_version']!==CURRENT_SCHEMA_VERSION,n=p['forked_from'];}catch{}}if(existsSync(i))try{const q=JSON['parse'](readFileSync(i,'utf-8'));k=q['archived'];}catch{}let o=0x0;try{o=statSync(g)['mtimeMs'];}catch{}c['push']({'dir_name':d['name'],'prefix':f['prefix'],'version':f['version'],'path':g,'initialized':j,'archived':k,'needs_migration':l,'forked_from':n,'mtime':o});}return c['sort']((r,t)=>t['mtime']-r['mtime']);}export function projectExists(a,b){return existsSync(manifestPath(a,b));}export function forkProject(a,b,c){if(!projectExists(a,b))throw new Error('source\x20project\x20not\x20found:\x20'+a+'_'+b);const d=c['newPrefix']??a;if(c['newVersion']===b&&d===a)throw new Error('fork\x20target\x20must\x20differ\x20from\x20source\x20(set\x20newVersion\x20or\x20newPrefix)');ensureProjectDir(d,c['newVersion']);const e=projectDir(a,b),f=projectDir(d,c['newVersion']),g=[];function h(m){const n=join(e,m);if(!existsSync(n))return;const o=readdirSync(n,{'withFileTypes':!![]});for(const p of o){const q=m?join(m,p['name']):p['name'],r=join(e,q),s=join(f,q);if(p['isDirectory']())mkdirSync(s,{'recursive':!![]}),h(q);else{if(p['isFile']()){if(q==='stage.json'||q==='audit.jsonl')continue;mkdirSync(dirname(s),{'recursive':!![]}),copyFileSync(r,s),g['push'](q);}}}}h('');const i=new Date()['toISOString'](),j={'schema_version':CURRENT_SCHEMA_VERSION,'mcp_version':c['mcpVersion']??'unknown','prefix':d,'version':c['newVersion'],'created_at':i,'updated_at':i,'forked_from':e};writeFileSync(manifestPath(d,c['newVersion']),JSON['stringify'](j,null,0x2),'utf-8');const k={'stage':0x1,'updated_at':Date['now'](),'stage_meta':{0x1:{'committed':![],'gate_passed':![],'blocking_issues':[],'completion':0x0},0x2:{'committed':![],'gate_passed':![],'blocking_issues':[],'completion':0x0},0x3:{'committed':![],'gate_passed':![],'blocking_issues':[],'completion':0x0},0x4:{'committed':![],'gate_passed':![],'blocking_issues':[],'completion':0x0},0x5:{'committed':![],'gate_passed':![],'blocking_issues':[],'completion':0x0}},'has_published_object':![],'archived':![]};saveStageState(d,c['newVersion'],k),appendAudit(d,c['newVersion'],{'timestamp':i,'event':'fork_created','reason':'forked\x20from\x20'+a+'_'+b+';\x20objects\x20must\x20be\x20re-created\x20(project\x20isolation\x20§3.0)','affected_files':['manifest.json','stage.json']});const l=loadStageState(a,b);return l&&(l['archived']=!![],saveStageState(a,b,l),appendAudit(a,b,{'timestamp':i,'event':'stage_commit','reason':'archived\x20after\x20fork\x20to\x20'+d+'_'+c['newVersion'],'affected_files':['stage.json']})),{'new_prefix':d,'new_version':c['newVersion'],'new_path':f,'forked_from':e,'copied_files':g};}export function listProjectFiles(a,b){const c=projectDir(a,b);if(!existsSync(c))return[];const d=[];function e(f){const g=join(c,f),h=readdirSync(g,{'withFileTypes':!![]});for(const i of h){const j=f?join(f,i['name']):i['name'],k=join(c,j);if(i['isDirectory']())e(j);else{if(i['isFile']()){let l;try{l=statSync(k);}catch{continue;}let m='other';if(k['endsWith']('.json'))m='json';else{if(k['endsWith']('.md'))m='markdown';else{if(k['endsWith']('.jsonl'))m='jsonl';}}d['push']({'path':j,'abs_path':k,'size':l['size'],'mtime':l['mtimeMs'],'kind':m});}}}}return e(''),d['sort']((f,g)=>f['path']['localeCompare'](g['path']));}export function readProjectFile(a,b,c){const d=join(projectDir(a,b),c);if(!existsSync(d))return undefined;return readFileSync(d,'utf-8');}export function commitStage(a,b,c,d={}){const e=loadStageState(a,b);if(!e)throw new Error('project\x20not\x20initialized:\x20'+a+'_'+b);const f=d['gatePassed']??![];return e['stage_meta'][c]={'committed':!![],'committed_at':Date['now'](),'gate_passed':f,'blocking_issues':d['blockingIssues']??[],'completion':d['completion']??(f?0x64:0x0)},c<0x5&&f&&(e['stage']=c+0x1),saveStageState(a,b,e),appendAudit(a,b,{'timestamp':new Date()['toISOString'](),'event':'stage_commit','stage':c,'reason':d['reason']??'stage\x20'+c+'\x20committed','affected_files':['stage.json'],'user_confirmed':d['userConfirmed']}),e;}export function rollbackStage(a,b,c,d={}){const e=loadStageState(a,b);if(!e)throw new Error('project\x20not\x20initialized:\x20'+a+'_'+b);if(e['has_published_object'])throw new Error('cannot\x20rollback:\x20project\x20has\x20published\x20objects\x20—\x20must\x20fork\x20new\x20version\x20(§3.3)');const f=e['stage'];for(let g=c+0x1;g<=0x5;g++){e['stage_meta'][g]={'committed':![],'gate_passed':![],'blocking_issues':[],'completion':0x0};}return e['stage']=c,saveStageState(a,b,e),appendAudit(a,b,{'timestamp':new Date()['toISOString'](),'event':'stage_rollback','stage':c,'reason':d['reason']??'rollback\x20from\x20stage\x20'+f+'\x20to\x20'+c,'affected_files':d['affectedFiles']??['stage.json']}),e;}export function markObjectPublished(a,b,c){const d=loadStageState(a,b);if(!d)return;if(d['has_published_object'])return;d['has_published_object']=!![],saveStageState(a,b,d),appendAudit(a,b,{'timestamp':new Date()['toISOString'](),'event':'object_published','stage':0x5,'reason':'object\x20published:\x20'+c+'\x20—\x20rollback\x20now\x20requires\x20fork\x20(§3.3)','affected_files':['stage.json']});}export function getLocalSyncStatus(a,b){const c=projectExists(a,b);if(!c)return{'local_exists':![],'initialized':![],'needs_migration':![],'archived':![]};let d=!![],e=![],f=![];try{const g=loadManifest(a,b);e=g['schema_version']!==CURRENT_SCHEMA_VERSION;}catch{d=![];}try{const h=loadStageState(a,b);if(h)f=h['archived'];}catch{}return{'local_exists':!![],'initialized':d,'needs_migration':e,'archived':f};}

package/dist/project/query.js

@@ -1,153 +1 @@
-import { LocalMark } from "@wowok/wowok";
-import { extractAllProjectVersions, TAG_PREFIX } from "./namespace.js";
-export async function listProjects() {
-    const marks = await LocalMark.Instance().list(undefined);
-    const byProject = new Map();
-    for (const m of marks) {
-        const entries = extractAllProjectVersions(m.tags);
-        if (entries.length === 0)
-            continue;
-        const byPrefix = new Map();
-        for (const entry of entries) {
-            if (!byPrefix.has(entry.prefix))
-                byPrefix.set(entry.prefix, []);
-            byPrefix.get(entry.prefix).push(entry.version);
-        }
-        const typeTag = m.tags?.find((t) => t.startsWith(TAG_PREFIX.type));
-        const type = typeTag?.slice(TAG_PREFIX.type.length);
-        for (const [prefix, versions] of byPrefix) {
-            const hasVersioned = versions.some((v) => v !== undefined);
-            const effectiveVersions = hasVersioned
-                ? versions.filter((v) => v !== undefined)
-                : versions;
-            if (!byProject.has(prefix)) {
-                byProject.set(prefix, {
-                    prefix,
-                    objectCount: 0,
-                    types: [],
-                    versions: [],
-                    objects: [],
-                });
-            }
-            const proj = byProject.get(prefix);
-            if (type && !proj.types.includes(type))
-                proj.types.push(type);
-            for (const v of effectiveVersions) {
-                proj.objectCount++;
-                if (v && !proj.versions.includes(v)) {
-                    proj.versions.push(v);
-                }
-                proj.objects.push({
-                    name: m.name,
-                    address: m.address,
-                    type,
-                    version: v,
-                    tags: m.tags,
-                });
-            }
-        }
-    }
-    return Array.from(byProject.values()).sort((a, b) => b.objectCount - a.objectCount);
-}
-export async function listProjectObjects(prefix) {
-    const marks = await LocalMark.Instance().list(undefined);
-    const results = [];
-    const isVersionedFilter = prefix.includes("_v");
-    for (const m of marks) {
-        const entries = extractAllProjectVersions(m.tags);
-        const matched = entries.find((e) => {
-            if (isVersionedFilter) {
-                return e.version ? `${e.prefix}_${e.version}` === prefix : false;
-            }
-            return e.prefix === prefix;
-        });
-        if (!matched)
-            continue;
-        const typeTag = m.tags?.find((t) => t.startsWith(TAG_PREFIX.type));
-        results.push({
-            name: m.name,
-            address: m.address,
-            type: typeTag?.slice(TAG_PREFIX.type.length),
-            version: matched.version,
-            tags: m.tags,
-        });
-    }
-    return results;
-}
-export async function listShareableObjects() {
-    const marks = await LocalMark.Instance().list({ tags: [`${TAG_PREFIX.shareable}true`] });
-    return marks.map((m) => {
-        const typeTag = m.tags?.find((t) => t.startsWith(TAG_PREFIX.type));
-        const projectTag = m.tags?.find((t) => t.startsWith(TAG_PREFIX.project));
-        return {
-            name: m.name,
-            address: m.address,
-            type: typeTag?.slice(TAG_PREFIX.type.length),
-            project: projectTag?.slice(TAG_PREFIX.project.length),
-        };
-    });
-}
-export function traceDependencies(graph, objectId) {
-    const directDependencies = graph.getDependencies(objectId);
-    const visited = new Set([objectId]);
-    const transitive = [];
-    const queue = directDependencies.map((e) => ({ id: e.to, via: [e.from, e.to] }));
-    const dangling = new Set();
-    while (queue.length > 0) {
-        const { id, via } = queue.shift();
-        if (visited.has(id))
-            continue;
-        visited.add(id);
-        const node = graph.getNode(id);
-        if (!node || (!node.address && !node.project)) {
-            dangling.add(id);
-        }
-        transitive.push({ object: id, via });
-        const nextEdges = graph.getDependencies(id);
-        for (const e of nextEdges) {
-            if (!visited.has(e.to)) {
-                queue.push({ id: e.to, via: [...via, e.to] });
-            }
-        }
-    }
-    return {
-        object: objectId,
-        directDependencies,
-        transitive,
-        dangling: Array.from(dangling),
-    };
-}
-export function traceReferencedBy(graph, objectId) {
-    return {
-        object: objectId,
-        referencedBy: graph.getReferencedBy(objectId),
-    };
-}
-export function prePublishCheck(graph, serviceId) {
-    const warnings = [];
-    const trace = traceDependencies(graph, serviceId);
-    if (trace.dangling.length > 0) {
-        warnings.push(`Service '${serviceId}' references objects not yet created: ${trace.dangling.join(", ")}. ` +
-            `Publishing will lock 'machine' and 'order_allocators' — ensure these are finalized first.`);
-    }
-    const cycles = graph.detectCycles();
-    if (cycles.length > 0) {
-        warnings.push(`Dependency graph contains ${cycles.length} cycle(s): ` +
-            cycles.map((c) => c.join(" → ")).join("; ") +
-            `. Cycles may indicate a design issue.`);
-    }
-    return warnings;
-}
-export function findCrossProjectReferences(graph) {
-    const result = [];
-    for (const edge of graph.getEdges()) {
-        const fromNode = graph.getNode(edge.from);
-        const toNode = graph.getNode(edge.to);
-        const fromProj = fromNode?.project;
-        const toProj = toNode?.project;
-        if (fromProj && toProj && fromProj !== toProj) {
-            result.push({ edge, fromProject: fromProj, toProject: toProj });
-        }
-    }
-    return result;
-}
+import{LocalMark}from'@wowok/wowok';import{extractAllProjectVersions,TAG_PREFIX}from'./namespace.js';export async function listProjects(){const a=await LocalMark['Instance']()['list'](undefined),b=new Map();for(const c of a){const d=extractAllProjectVersions(c['tags']);if(d['length']===0x0)continue;const e=new Map();for(const h of d){if(!e['has'](h['prefix']))e['set'](h['prefix'],[]);e['get'](h['prefix'])['push'](h['version']);}const f=c['tags']?.['find'](i=>i['startsWith'](TAG_PREFIX['type'])),g=f?.['slice'](TAG_PREFIX['type']['length']);for(const [i,j]of e){const k=j['some'](o=>o!==undefined),l=k?j['filter'](o=>o!==undefined):j;!b['has'](i)&&b['set'](i,{'prefix':i,'objectCount':0x0,'types':[],'versions':[],'objects':[]});const n=b['get'](i);if(g&&!n['types']['includes'](g))n['types']['push'](g);for(const o of l){n['objectCount']++,o&&!n['versions']['includes'](o)&&n['versions']['push'](o),n['objects']['push']({'name':c['name'],'address':c['address'],'type':g,'version':o,'tags':c['tags']});}}}return Array['from'](b['values']())['sort']((p,q)=>q['objectCount']-p['objectCount']);}export async function listProjectObjects(a){const b=await LocalMark['Instance']()['list'](undefined),c=[],d=a['includes']('_v');for(const e of b){const f=extractAllProjectVersions(e['tags']),g=f['find'](i=>{if(d)return i['version']?i['prefix']+'_'+i['version']===a:![];return i['prefix']===a;});if(!g)continue;const h=e['tags']?.['find'](i=>i['startsWith'](TAG_PREFIX['type']));c['push']({'name':e['name'],'address':e['address'],'type':h?.['slice'](TAG_PREFIX['type']['length']),'version':g['version'],'tags':e['tags']});}return c;}export async function listShareableObjects(){const a=await LocalMark['Instance']()['list']({'tags':[TAG_PREFIX['shareable']+'true']});return a['map'](b=>{const c=b['tags']?.['find'](e=>e['startsWith'](TAG_PREFIX['type'])),d=b['tags']?.['find'](e=>e['startsWith'](TAG_PREFIX['project']));return{'name':b['name'],'address':b['address'],'type':c?.['slice'](TAG_PREFIX['type']['length']),'project':d?.['slice'](TAG_PREFIX['project']['length'])};});}export function traceDependencies(a,b){const c=a['getDependencies'](b),d=new Set([b]),f=[],g=c['map'](i=>({'id':i['to'],'via':[i['from'],i['to']]})),h=new Set();while(g['length']>0x0){const {id:i,via:j}=g['shift']();if(d['has'](i))continue;d['add'](i);const k=a['getNode'](i);(!k||!k['address']&&!k['project'])&&h['add'](i);f['push']({'object':i,'via':j});const l=a['getDependencies'](i);for(const m of l){!d['has'](m['to'])&&g['push']({'id':m['to'],'via':[...j,m['to']]});}}return{'object':b,'directDependencies':c,'transitive':f,'dangling':Array['from'](h)};}export function traceReferencedBy(a,b){return{'object':b,'referencedBy':a['getReferencedBy'](b)};}export function prePublishCheck(a,b){const c=[],d=traceDependencies(a,b);d['dangling']['length']>0x0&&c['push']('Service\x20\x27'+b+'\x27\x20references\x20objects\x20not\x20yet\x20created:\x20'+d['dangling']['join'](',\x20')+'.\x20'+'Publishing\x20will\x20lock\x20\x27machine\x27\x20and\x20\x27order_allocators\x27\x20—\x20ensure\x20these\x20are\x20finalized\x20first.');const e=a['detectCycles']();return e['length']>0x0&&c['push']('Dependency\x20graph\x20contains\x20'+e['length']+'\x20cycle(s):\x20'+e['map'](f=>f['join']('\x20→\x20'))['join'](';\x20')+'.\x20Cycles\x20may\x20indicate\x20a\x20design\x20issue.'),c;}export function findCrossProjectReferences(a){const b=[];for(const c of a['getEdges']()){const d=a['getNode'](c['from']),e=a['getNode'](c['to']),f=d?.['project'],g=e?.['project'];f&&g&&f!==g&&b['push']({'edge':c,'fromProject':f,'toProject':g});}return b;}

package/dist/project/reverse-mapping.d.ts

@@ -0,0 +1,34 @@
+export interface MerchantProfile {
+    serviceDescription: string;
+    workflowDescription: string;
+    refundPolicy: string;
+    arbitrationPolicy: string;
+}
+export interface UserRiskAssessment {
+    riskLevel: "low" | "medium" | "high" | "critical";
+    keyRisks: string[];
+    protections: string[];
+    missingProtections: string[];
+}
+export interface GameTheoryAnalysis {
+    merchantIncentives: string[];
+    userIncentives: string[];
+    potentialConflicts: string[];
+    wowAlignments: string[];
+}
+export interface BusinessReport {
+    summary: string;
+    merchantProfile: MerchantProfile;
+    userRiskAssessment: UserRiskAssessment;
+    gameTheoryAnalysis: GameTheoryAnalysis;
+}
+export interface ReverseMappingInput {
+    objects: unknown[];
+    machine_nodes?: Array<{
+        name: string;
+    }>;
+    order_amount?: string;
+}
+export declare function generateBusinessReport(input: ReverseMappingInput): BusinessReport;
+export declare function classifyObjectType(obj: unknown): string;
+export declare function extractObjectFields(obj: unknown): Record<string, unknown>;

package/dist/project/reverse-mapping.js

@@ -0,0 +1 @@
+function fld(a,b){return a?.[b]??a?.['data']?.[b];}function detectType(a){const b=fld(a,'type')??fld(a,'type_raw');if(typeof b!=='string'||b['length']===0x0)return'';const c=b['split']('::')['pop']()??b;return c;}function objectsOfType(a,b){return a['filter'](c=>detectType(c)===b);}function identity(a){const b=fld(a,'name');if(typeof b==='string'&&b['trim']())return b['trim']();const c=fld(a,'object')??fld(a,'id');if(typeof c==='string'&&c['trim']())return c['trim']();return'unknown';}function balanceStr(a){if(a==null)return undefined;if(typeof a==='object'&&'balance'in a)return String(a['balance']);return String(a);}function extractService(a){const b=objectsOfType(a,'Service')[0x0];if(!b)return{'found':![],'name':'unavailable','description':'No\x20Service\x20object\x20found','published':![],'paused':![],'salesCount':0x0,'arbitrations':[],'hasBuyGuard':![],'hasUm':![],'rewardsCount':0x0};return{'found':!![],'name':identity(b),'description':fld(b,'description')??'Service\x20(no\x20description)','published':fld(b,'bPublished')??![],'paused':fld(b,'bPaused')??![],'salesCount':Array['isArray'](fld(b,'sales'))?fld(b,'sales')['length']:0x0,'arbitrations':(fld(b,'arbitrations')??[])['filter'](c=>!!c),'compensationFund':balanceStr(fld(b,'compensation_fund')),'hasBuyGuard':fld(b,'buy_guard')!=null,'hasUm':fld(b,'um')!=null,'rewardsCount':(fld(b,'rewards')??[])['length']};}const TERMINAL_SUFFIXES=['complete','completed','done','finish','finished','delivered','accepted','refund','cancelled','canceled'];function extractMachine(a,b){const c=objectsOfType(a,'Machine')[0x0];if(!c)return{'found':![],'nodeCount':0x0,'published':![],'paused':![],'entryNodes':[],'terminalNodeNames':[]};const d=(b??[])['map'](f=>f['name'])['filter'](f=>typeof f==='string'),e=d['filter'](f=>TERMINAL_SUFFIXES['some'](g=>f['toLowerCase']()['includes'](g)));return{'found':!![],'nodeCount':fld(c,'node_count')??d['length'],'published':fld(c,'bPublished')??![],'paused':fld(c,'bPaused')??![],'entryNodes':[],'terminalNodeNames':e};}function hasRefundPath(a,b){return a['terminalNodeNames']['some'](c=>/refund|cancel/i['test'](c))||b;}function detectAllocationRefundSlot(a){const b=objectsOfType(a,'Service')[0x0],c=fld(b,'order_allocators'),d=Array['isArray'](c)?c:Array['isArray'](c?.['allocators'])?c['allocators']:[];for(const e of d){for(const f of e?.['sharing']??[]){const g=f?.['who'];if(g==null)continue;if(typeof g==='object'&&'Signer'in g)return!![];if(typeof g==='object'&&'Entity'in g)continue;}}return![];}export function generateBusinessReport(a){const b=a['objects']??[],c=extractService(b),d=extractMachine(b,a['machine_nodes']),e=detectAllocationRefundSlot(b),f=hasRefundPath(d,e),g=c['arbitrations']['length']>0x0,h=c['compensationFund'],i=h==null||h==='0',j=!c['found']?'unavailable':c['paused']?'published\x20but\x20PAUSED':c['published']?'published\x20and\x20active':'not\x20yet\x20published',k=!c['found']?'No\x20Service\x20object\x20available\x20to\x20describe.':c['description']+'\x20('+j+(c['salesCount']>0x0?',\x20'+c['salesCount']+'\x20sale\x20option(s)':'')+').',l=!d['found']?'Workflow\x20(Machine)\x20unavailable\x20—\x20cannot\x20describe\x20the\x20process.':d['nodeCount']>0x0?d['nodeCount']+'-node\x20workflow\x20('+(d['published']?'published':'draft')+(d['paused']?',\x20paused':'')+').'+(d['terminalNodeNames']['length']>0x0?'\x20Terminal/refund\x20nodes\x20detected:\x20'+d['terminalNodeNames']['join'](',\x20')+'.':'\x20No\x20explicit\x20terminal\x20node\x20detected\x20from\x20names.'):'Workflow\x20node\x20details\x20unavailable\x20(node_count\x20not\x20resolved).',m=f?'A\x20refund\x20path\x20is\x20present\x20(refund\x20terminal\x20node\x20or\x20a\x20payer-routed\x20allocation\x20slot).':'NO\x20refund\x20path\x20detected\x20—\x20funds\x20may\x20be\x20unrecoverable\x20once\x20the\x20workflow\x20advances\x20to\x20completion.',n=g?c['arbitrations']['length']+'\x20arbitration\x20service(s)\x20bound\x20—\x20disputes\x20have\x20a\x20resolution\x20path.':'NO\x20arbitration\x20bound\x20—\x20disputes\x20have\x20no\x20neutral\x20resolution\x20path.',o=[];if(!c['published']||c['paused'])o['push']('Service\x20is\x20not\x20published\x20or\x20is\x20paused\x20—\x20purchase\x20would\x20fail\x20or\x20be\x20rejected.');if(!f)o['push']('No\x20refund\x20path\x20—\x20escrowed\x20funds\x20may\x20be\x20unrecoverable.');if(!g)o['push']('No\x20arbitration\x20bound\x20—\x20no\x20dispute\x20recourse.');if(i)o['push']('Compensation\x20fund\x20is\x20empty\x20—\x20arbitration\x20indemnity\x20would\x20be\x20unenforceable.');if(!c['hasUm'])o['push']('No\x20contact\x20(um)\x20configured\x20—\x20no\x20Messenger\x20channel\x20to\x20reach\x20the\x20merchant.');const p=[];if(c['published']&&!c['paused'])p['push']('Service\x20is\x20published\x20and\x20active.');if(f)p['push']('Refund\x20path\x20present.');if(g)p['push']('Arbitration\x20bound\x20(neutral\x20dispute\x20resolution).');if(!i)p['push']('Compensation\x20fund\x20funded\x20('+h+'\x20raw\x20units)\x20—\x20indemnity\x20enforceable.');if(c['hasBuyGuard'])p['push']('Buy\x20guard\x20present\x20(purchase\x20is\x20validated\x20by\x20on-chain\x20rules).');const q=[];if(!f)q['push']('Refund\x20path');if(!g)q['push']('Arbitration');if(i)q['push']('Compensation\x20fund');if(!c['hasUm'])q['push']('Contact\x20channel\x20(um)');let r='low';if(!c['published']||c['paused']||!f&&!g||!c['hasUm'])r='critical';else{if(!f||!g)r='high';else i&&(r='medium');}const s=[];s['push']('Escrowed\x20settlement:\x20funds\x20release\x20only\x20when\x20the\x20workflow\x20advances\x20—\x20the\x20merchant\x20is\x20incentivized\x20to\x20deliver.'),s['push']('On-chain\x20reputation\x20(Registrar\x20like/dislike\x20+\x20dispute\x20rate)\x20is\x20a\x20public\x20trust\x20signal\x20for\x20future\x20buyers.');if(c['rewardsCount']>0x0)s['push'](c['rewardsCount']+'\x20reward(s)\x20configured\x20—\x20repeat-buyer\x20incentives\x20lower\x20acquisition\x20cost.');const t=[];t['push']('Escrow\x20safety:\x20money\x20is\x20locked\x20on-chain\x20until\x20completion,\x20not\x20held\x20by\x20the\x20merchant.');if(f)t['push']('Refund\x20path\x20exists\x20—\x20a\x20verified\x20refund\x20returns\x20the\x20escrow.');if(g)t['push']('Arbitration\x20recourse\x20—\x20a\x20neutral\x20third\x20party\x20can\x20rule\x20on\x20disputes.');if(!i)t['push']('Compensation\x20fund\x20backs\x20arbitration\x20indemnity.');const u=[];u['push']('Merchant\x20wants\x20settlement\x20released\x20early;\x20user\x20wants\x20to\x20verify\x20the\x20deliverable\x20first\x20—\x20the\x20workflow\x27s\x20confirm\x20step\x20is\x20the\x20contention\x20point.'),u['push']('Merchant\x20controls\x20the\x20Machine/Guards;\x20user\x20is\x20limited\x20to\x20the\x20confirm/refund\x20forwards\x20the\x20merchant\x20designed.');if(!g)u['push']('No\x20arbitration:\x20a\x20deadlock\x20has\x20no\x20neutral\x20tie-breaker.');const v=[];v['push']('Escrow\x20alignment:\x20funds\x20stay\x20locked\x20until\x20both\x20sides\x20advance\x20the\x20workflow\x20—\x20neither\x20can\x20unilaterally\x20take\x20the\x20money.');if(f)v['push']('Allocation\x20alignment:\x20a\x20refund\x20slot\x20routes\x20the\x20escrow\x20back\x20to\x20the\x20buyer\x20on\x20the\x20refund\x20path.');if(g)v['push']('Arbitration\x20alignment:\x20an\x20independent\x20Permission\x20+\x20public\x20voters\x20provide\x20a\x20neutral\x20dispute\x20authority.');v['push']('Reputation\x20alignment:\x20Registrar\x20like/dislike\x20is\x20framework-enforced\x20and\x20unforgeable\x20—\x20both\x20sides\x20are\x20accountable\x20to\x20public\x20history.');const w=r['toUpperCase'](),x=a['order_amount']!=null?'\x20'+a['order_amount']+'\x20raw\x20units\x20are\x20escrowed.':'',y=!c['found']?'No\x20Service\x20object\x20found\x20—\x20reverse\x20mapping\x20produced\x20a\x20minimal\x20report.':'\x22'+c['name']+'\x22\x20is\x20'+j+'.'+x+'\x20'+('Risk\x20level:\x20'+w+'.\x20'+(f?'Refund\x20path\x20present.':'NO\x20refund\x20path.')+'\x20')+((g?'Arbitration\x20bound.':'NO\x20arbitration.')+'\x20')+'This\x20report\x20is\x20generated\x20deterministically\x20from\x20on-chain\x20facts\x20—\x20the\x20buyer\x20decides.';return{'summary':y,'merchantProfile':{'serviceDescription':k,'workflowDescription':l,'refundPolicy':m,'arbitrationPolicy':n},'userRiskAssessment':{'riskLevel':r,'keyRisks':o,'protections':p,'missingProtections':q},'gameTheoryAnalysis':{'merchantIncentives':s,'userIncentives':t,'potentialConflicts':u,'wowAlignments':v}};}export function classifyObjectType(a){return detectType(a);}export function extractObjectFields(a){if(!a||typeof a!=='object')return{};const b=a['data']??a;if(!b||typeof b!=='object')return{};return{...b};}