analyzthis_design 2.0.0 → 2.1.0

package/dist/lib/session.js

@@ -1,2 +1,186 @@
 #!/usr/bin/env node
-'use strict';const fs=require('fs'),path=require('path'),os=require('os'),crypto=require('crypto'),cache=require('./cache'),SESSIONS_ROOT=path['join'](os['homedir'](),'.analyzthis_design','sessions');function getProjectId(a=process['cwd']()){const b=path['resolve'](a),c=path['basename'](b)['toLowerCase']()['replace'](/[^a-z0-9-]+/g,'-')['replace'](/^-+|-+$/g,'')||'project',d=crypto['createHash']('sha1')['update'](b)['digest']('hex')['slice'](0x0,0x8);return c+'-'+d;}function sessionDir(a){return path['join'](SESSIONS_ROOT,a);}function sessionPath(a){return path['join'](sessionDir(a),'session-state.json');}function defaultState(a){const b=new Date()['toISOString']();return{'project_id':a,'created_at':b,'updated_at':b,'task_map':[],'figma_node':{'url':'','confirmed':![]},'content_sources':[],'ds_checklist':{'no_invented_hex':null,'no_important_overrides':null,'kit_components_preferred':null,'light_dark_from_tokens_only':null,'contrast_checked_against_wcag':null},'information_hierarchy':{'declared_by':'undeclared','ranking':[]},'routing_decision':{'problem_type':'','experts':[],'reason':''},'persona_outputs':{},'full_prompts':{},'structured_outputs':{},'covered_points':[],'task_type':'','verify_results':{'primary_task':'not_run','screenshots':[],'reason':''},'mode':'assess_only','design_spec':null,'feedback_log':[],'outcome':{'inferred':{},'confirmed':{}},'vault_path':'','last_collect_at':'','deliberation':{'round':0x0,'max_rounds':0x3,'satisfaction_threshold':0.4,'open_objections':[],'round_log':[],'consensus_reached':![],'raj_escalated':![],'mode':'adversarial'},'digest':{'task_map_summary':'','hierarchy_top3':[],'ds_at_risk':[],'experts':[],'prior_scores':{},'mode':'assess_only'},'metrics':{'llm_calls':0x0,'experts_run':[],'input_tokens_est':0x0,'output_tokens_est':0x0,'cache_hits':0x0,'mode':'lite','effort_log':[],'cost_usd':0x0,'deliberation_rounds':0x0,'objections_raised':0x0,'objections_resolved':0x0,'raj_escalations':0x0}};}function init({project:a}={}){const b=a||getProjectId(),c=sessionDir(b);fs['mkdirSync'](c,{'recursive':!![]});const d=sessionPath(b);return fs['writeFileSync'](d,JSON['stringify'](defaultState(b),null,0x2)),{'projectId':b,'filePath':d};}function show({project:a}={}){const b=a||getProjectId(),c=sessionPath(b);if(!fs['existsSync'](c))return null;try{return JSON['parse'](fs['readFileSync'](c,'utf8'));}catch{return null;}}function reset({project:a,all:all=![]}={}){if(all)return fs['rmSync'](SESSIONS_ROOT,{'recursive':!![],'force':!![]}),cache['invalidatePrefix']('kb:'),{'removed':'all'};const b=a||getProjectId();return fs['rmSync'](sessionDir(b),{'recursive':!![],'force':!![]}),cache['invalidatePrefix']('kb:'+b+':'),{'removed':b};}function update({project:a,patch:patch={}}={}){const b=a||getProjectId(),c=show({'project':b})||defaultState(b),d={...c,...patch,'updated_at':new Date()['toISOString']()},e=sessionDir(b);return fs['mkdirSync'](e,{'recursive':!![]}),fs['writeFileSync'](sessionPath(b),JSON['stringify'](d,null,0x2)),d;}function listProjects(){if(!fs['existsSync'](SESSIONS_ROOT))return[];return fs['readdirSync'](SESSIONS_ROOT,{'withFileTypes':!![]})['filter'](a=>a['isDirectory']()&&fs['existsSync'](sessionPath(a['name'])))['map'](a=>a['name']);}function markAccepted({project:a,persona:b,accepted:accepted=!![]}={}){const c=a||getProjectId(),d=show({'project':c});if(!d||!d['persona_outputs']||!d['persona_outputs'][b])return{'updated':![],'reason':'No\x20output\x20recorded\x20for\x20persona\x20\x22'+b+'\x22\x20in\x20this\x20session\x20yet.'};d['persona_outputs'][b]['accepted']=accepted;const e=update({'project':c,'patch':{'persona_outputs':d['persona_outputs']}});return{'updated':!![],'state':e};}module['exports']={'getProjectId':getProjectId,'sessionPath':sessionPath,'sessionDir':sessionDir,'init':init,'show':show,'reset':reset,'update':update,'listProjects':listProjects,'markAccepted':markAccepted,'SESSIONS_ROOT':SESSIONS_ROOT};
+'use strict';
+
+const fs     = require('fs');
+const path   = require('path');
+const os     = require('os');
+const crypto = require('crypto');
+const cache  = require('./cache');
+
+const SESSIONS_ROOT = path.join(os.homedir(), '.analyzthis_design', 'sessions');
+
+// ─── Project identity ────────────────────────────────────────────────────────
+
+// A project id is a short, filesystem-safe slug derived from the working
+// directory so different repos never collide, and the same repo always
+// resolves to the same session file across turns.
+function getProjectId(cwd = process.cwd()) {
+  const abs  = path.resolve(cwd);
+  const slug = path.basename(abs).toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '') || 'project';
+  const hash = crypto.createHash('sha1').update(abs).digest('hex').slice(0, 8);
+  return `${slug}-${hash}`;
+}
+
+function sessionDir(projectId) {
+  return path.join(SESSIONS_ROOT, projectId);
+}
+
+function sessionPath(projectId) {
+  return path.join(sessionDir(projectId), 'session-state.json');
+}
+
+// ─── Default shape (mirrors agents/session-schema.json) ─────────────────────
+
+function defaultState(projectId) {
+  const now = new Date().toISOString();
+  return {
+    project_id: projectId,
+    created_at: now,
+    updated_at: now,
+    task_map: [],
+    figma_node: { url: '', confirmed: false },
+    content_sources: [],
+    ds_checklist: {
+      no_invented_hex: null,
+      no_important_overrides: null,
+      kit_components_preferred: null,
+      light_dark_from_tokens_only: null,
+      contrast_checked_against_wcag: null,
+    },
+    information_hierarchy: { declared_by: 'undeclared', ranking: [] },
+    routing_decision: { problem_type: '', experts: [], reason: '' },
+    persona_outputs: {},
+    full_prompts: {},
+    structured_outputs: {},
+    covered_points: [],
+    task_type: '',
+    verify_results: { primary_task: 'not_run', screenshots: [], reason: '' },
+    mode: 'assess_only',
+    design_spec: null,
+    feedback_log: [],
+    outcome: {
+      inferred: {},
+      confirmed: {},
+    },
+    vault_path: '',
+    last_collect_at: '',
+    deliberation: {
+      round: 0,
+      max_rounds: 3,
+      satisfaction_threshold: 0.4,
+      open_objections: [],
+      round_log: [],
+      consensus_reached: false,
+      raj_escalated: false,
+      mode: 'adversarial',
+    },
+    digest: {
+      task_map_summary: '',
+      hierarchy_top3: [],
+      ds_at_risk: [],
+      experts: [],
+      prior_scores: {},
+      mode: 'assess_only',
+    },
+    metrics: {
+      llm_calls: 0,
+      experts_run: [],
+      input_tokens_est: 0,
+      output_tokens_est: 0,
+      cache_hits: 0,
+      mode: 'lite',
+      effort_log: [],
+      cost_usd: 0,
+      deliberation_rounds: 0,
+      objections_raised: 0,
+      objections_resolved: 0,
+      raj_escalations: 0,
+    },
+  };
+}
+
+// ─── Public API ──────────────────────────────────────────────────────────────
+
+/**
+ * Create (or overwrite) a fresh session-state.json for the given project.
+ */
+function init({ project } = {}) {
+  const projectId = project || getProjectId();
+  const dir = sessionDir(projectId);
+  fs.mkdirSync(dir, { recursive: true });
+  const filePath = sessionPath(projectId);
+  fs.writeFileSync(filePath, JSON.stringify(defaultState(projectId), null, 2));
+  return { projectId, filePath };
+}
+
+/**
+ * Read the current session state. Returns null if no session exists yet.
+ */
+function show({ project } = {}) {
+  const projectId = project || getProjectId();
+  const filePath = sessionPath(projectId);
+  if (!fs.existsSync(filePath)) return null;
+  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); }
+  catch { return null; }
+}
+
+/**
+ * Delete the session state for a project (or all projects if `all` is true).
+ */
+function reset({ project, all = false } = {}) {
+  if (all) {
+    fs.rmSync(SESSIONS_ROOT, { recursive: true, force: true });
+    cache.invalidatePrefix('kb:');
+    return { removed: 'all' };
+  }
+  const projectId = project || getProjectId();
+  fs.rmSync(sessionDir(projectId), { recursive: true, force: true });
+  cache.invalidatePrefix(`kb:${projectId}:`);
+  return { removed: projectId };
+}
+
+/**
+ * Merge a partial update into the session state, creating it first if needed.
+ * Used by the orchestrator skill (via CLI) to persist routing decisions,
+ * persona outputs, and gate results between turns.
+ */
+function update({ project, patch = {} } = {}) {
+  const projectId = project || getProjectId();
+  const existing = show({ project: projectId }) || defaultState(projectId);
+  const merged = { ...existing, ...patch, updated_at: new Date().toISOString() };
+  const dir = sessionDir(projectId);
+  fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(sessionPath(projectId), JSON.stringify(merged, null, 2));
+  return merged;
+}
+
+/**
+ * List every project id that currently has a session-state.json on disk.
+ * Used by `metrics --all` and `export-training --all`.
+ */
+function listProjects() {
+  if (!fs.existsSync(SESSIONS_ROOT)) return [];
+  return fs.readdirSync(SESSIONS_ROOT, { withFileTypes: true })
+    .filter((d) => d.isDirectory() && fs.existsSync(sessionPath(d.name)))
+    .map((d) => d.name);
+}
+
+/**
+ * Mark a persona's most recent output as accepted (or rejected) — the
+ * lightweight feedback flag the future LoRA training-pair export reads.
+ * No-ops if the persona hasn't produced an output yet.
+ */
+function markAccepted({ project, persona, accepted = true } = {}) {
+  const projectId = project || getProjectId();
+  const state = show({ project: projectId });
+  if (!state || !state.persona_outputs || !state.persona_outputs[persona]) {
+    return { updated: false, reason: `No output recorded for persona "${persona}" in this session yet.` };
+  }
+  state.persona_outputs[persona].accepted = accepted;
+  const merged = update({ project: projectId, patch: { persona_outputs: state.persona_outputs } });
+  return { updated: true, state: merged };
+}
+
+module.exports = {
+  getProjectId, sessionPath, sessionDir, init, show, reset, update, listProjects, markAccepted, SESSIONS_ROOT,
+};