workspai 0.58.0 → 0.59.1

package/dist/goal-pack-TWOXHXN6.js

@@ -0,0 +1 @@
+import {c as c$5}from'./chunk-5PSKBJKJ.js';import {c}from'./chunk-RVKMGKYL.js';import {i,h as h$1,d as d$1,f as f$2,c as c$3,e as e$1}from'./chunk-DQ6VXTDE.js';export{b as GOAL_AGENT_HANDOFF_SCHEMA_VERSION,f as GOAL_INDEX_PATH,e as GOAL_INDEX_SCHEMA_VERSION,g as GOAL_LIFECYCLE_RESULT_SCHEMA_VERSION,d as GOAL_PACK_LAST_RUN_PATH,a as GOAL_PACK_SCHEMA_VERSION,c as GOAL_PLAN_RESULT_SCHEMA_VERSION}from'./chunk-DQ6VXTDE.js';import {f as f$3}from'./chunk-4PUJVYRM.js';import {b}from'./chunk-GPOZILMY.js';import {a as a$1}from'./chunk-5NIZNXRS.js';import {c as c$4}from'./chunk-QFBVQUKV.js';import {d,c as c$1}from'./chunk-EWZZUQBR.js';import {c as c$2,f as f$1}from'./chunk-CCDGHPEJ.js';import {a}from'./chunk-AFIFZTOY.js';import {f,e}from'./chunk-NZ3WZYD5.js';import h from'path';import G from'fs-extra';var ce=/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/,ie=/(?:^|\s)(?:\/(?:home|Users|private|var|tmp|mnt|opt|srv|root|workspace|workspaces|data|Volumes|etc|usr|run|dev|proc|sys)\/[^\s]+|[A-Za-z]:[\\/][^\s]+|\\\\[^\\\s]+\\[^\s]+)/,le=/(?:-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----|\b(?:github_pat_|gh[pousr]_|glpat-|npm_|xox[baprs]-|sk-(?:proj-)?)[A-Za-z0-9_-]{12,}|\b(?:AKIA|ASIA)[A-Z0-9]{16}\b|\bAIza[A-Za-z0-9_-]{20,}|\bBearer\s+[A-Za-z0-9._~+/-]{16,}|[a-z][a-z0-9+.-]*:\/\/[^\s:/]+:[^\s@/]+@|\b(?:password|passwd|secret|token|api[_-]?key)\s*[:=]\s*[^\s]{6,})/i,pe=[{category:"test-coverage",patterns:[/\b(?:test\s+)?coverage\b/i,/\bcoverage\s+(?:to|above|at least)\b/i]},{category:"dependency-security",patterns:[/\b(?:dependency|dependencies|package|packages)\b.*\b(?:security|vulnerab|audit)\b/i,/\b(?:security|vulnerab|audit)\b.*\b(?:dependency|dependencies|package|packages)\b/i]},{category:"release-readiness",patterns:[/\brelease[ -]readiness\b/i,/\bready (?:this |the )?(?:workspace|project) for release\b/i,/\bprepare (?:this |the )?(?:workspace|project) for release\b/i,/\bprepare\b[^\n]{0,80}\bfor release\b/i]},{category:"defect-repair",patterns:[/\b(?:fix|repair|resolve|debug)\b.*\b(?:bug|error|failure|issue|regression)\b/i]},{category:"performance",patterns:[/\b(?:performance|latency|throughput|memory|cpu|optimi[sz]e|faster|slower)\b/i]},{category:"refactor",patterns:[/\b(?:refactor|restructure|decouple|extract|simplify|cleanup|clean up)\b/i]},{category:"documentation",patterns:[/\b(?:document|documentation|readme|guide|tutorial|docs)\b/i]},{category:"feature-change",patterns:[/\b(?:add|build|create|implement|introduce|support)\b/i]},{category:"system-understanding",patterns:[/\b(?:understand|explain|map|find|where|how|architecture|analy[sz]e|search)\b/i]}];function de(e){if(typeof e!="string")throw new Error("Goal intent must be text.");let t=e.trim().replace(/\s+/g," ");if(!t)throw new Error("Goal intent cannot be empty.");if(t.length>2e3)throw new Error("Goal intent exceeds the 2000 character safety limit.");if(ce.test(t))throw new Error("Goal intent contains unsupported control characters.");if(ie.test(t))throw new Error("Goal intent contains a machine-local absolute path. Use a workspace-relative path or project scope.");if(le.test(t))throw new Error("Goal intent appears to contain secret material and was not persisted.");return t}function ue(e){let t=e.match(/\b(?:coverage\D{0,24})?(100|\d{1,2})(?:\.\d+)?\s*%/i);if(!t||!/coverage/i.test(e))return null;let o=Number(t[1]);return Number.isFinite(o)&&o>=0&&o<=100?o:null}function Z(e){let t=de(e),o=pe.filter(c=>c.patterns.some(m=>m.test(t))).map(c=>c.category),r=o[0]??"feature-change",i=ue(t),l=[];return o.length>1&&o[0]!=="test-coverage"&&l.push(`The intent also contains signals for: ${o.slice(1).join(", ")}.`),r==="test-coverage"&&i===null&&l.push("A numeric test coverage target is required for machine verification."),{original:t,normalized:t.toLocaleLowerCase("en-US"),statement:t.replace(/[.!?]+$/,""),category:r,confidence:o.length===1?"high":o.length>1?"medium":"low",ambiguities:l,...i===null?{}:{requestedTarget:{metric:"test-coverage-percent",operator:"at-least",value:i}}}}function X(e){let t={"test-coverage":["test suite coverage configuration instrumentation","CI tests LCOV Cobertura JaCoCo LLVM coverage"],"dependency-security":["dependency manifest lockfile security audit vulnerability"],"release-readiness":["release pipeline readiness gates build test deploy"],"defect-repair":["failure error test implementation call path"],"feature-change":["API implementation module dependency tests"],refactor:["module dependency ownership implementation tests"],performance:["performance benchmark latency throughput runtime"],documentation:["documentation README guide architecture decision"],"system-understanding":["architecture service API dependency ownership"]};return [...new Set([e.statement,...t[e.category]])].slice(0,3)}var Q="contracts/workspace-intelligence/goal-pack.v1.json",Y="contracts/workspace-intelligence/goal-agent-handoff.v1.json",me="contracts/workspace-intelligence/goal-plan-result.v1.json",te="contracts/workspace-intelligence/goal-index.v1.json";function ee(e){return e.split(h.sep).join("/")}function q(e,t){return h.resolve(t.absolutePath??h.join(e,t.path))}function ge(e){let t=e.requested.trim().replace(/^project:/,"");if(!t)throw new Error("Project goal scope must name a project.");let o=h.isAbsolute(t)?h.resolve(t):null,r=e.model.projects.filter(i=>i.name===t||ee(i.path)===ee(t)||o!==null&&q(e.workspacePath,i)===o);if(r.length!==1)throw new Error(r.length===0?`Project goal scope was not found in the canonical model: ${t}`:`Project goal scope is ambiguous in the canonical model: ${t}`);return r[0]}async function fe(e){let t=await a$1(e);if(t.status==="miss")throw new Error(`Canonical model and live graph evidence are required (${t.reason}). Run \`workspai workspace intelligence run --for-agent generic --strict --json\` or retry with --refresh.`);let{model:o,graph:r}=t;return a(o,"contracts/workspace-intelligence/workspace-model.v1.json","Goal source model"),a(r,"contracts/workspace-intelligence/workspace-knowledge-graph.v1.json","Goal source graph"),c$4(r,o),{model:o,graph:r}}function he(e){if(e.explicitScope?.trim()==="workspace")return {kind:"workspace",projects:e.model.projects.map(t=>t.name).sort(),selectionSource:"explicit"};if(e.explicitScope?.trim())return {kind:"project",projects:[ge({workspacePath:e.workspacePath,model:e.model,requested:e.explicitScope}).name],selectionSource:"explicit"};if(e.invocationProjectPath){let t=h.resolve(e.invocationProjectPath),o=e.model.projects.filter(r=>q(e.workspacePath,r)===t);if(o.length!==1)throw new Error("The invocation project is not represented uniquely in the canonical workspace model. Refresh intelligence or pass --scope explicitly.");return {kind:"project",projects:[o[0].name],selectionSource:"invocation-project"}}return {kind:"workspace",projects:e.model.projects.map(t=>t.name).sort(),selectionSource:"workspace"}}function ke(e,t){if(t.kind==="workspace")return {entities:e.quality.entityCount,relationships:e.quality.relationCount,proofs:e.quality.proofCount,unresolved:e.quality.unknownCount,proofCoveragePercent:Number((e.quality.relationProofCoverageRatio*100).toFixed(2))};let o=new Set(t.projects),r=e.entities.filter(p=>p.projectId!==void 0&&o.has(p.projectId)),i=new Set(r.map(p=>p.id)),l=e.relations.filter(p=>i.has(p.from)||i.has(p.to)),c=new Set([...r.flatMap(p=>p.proofIds),...l.flatMap(p=>p.proofIds)]),m=l.filter(p=>p.proofIds.length>0).length;return {entities:r.length,relationships:l.length,proofs:c.size,unresolved:l.length-m,proofCoveragePercent:l.length===0?100:Number((m/l.length*100).toFixed(2))}}async function we(e$1){let t=new Set(["node","bun","deno","python","go","java","dotnet","rust","php","ruby","elixir","clojure","scala","kotlin","c","cpp","unknown"]),o=h.join(e$1.workspacePath,e.intelligenceRun),r=await G.readJson(o).catch(()=>null),l=(Array.isArray(r?.stages)?r.stages:[]).filter(a=>a.status==="blocked"||a.status==="failed").map(a=>String(a.id??"unknown")).sort(),c=r?.status,m={status:c==="passed"?"passed":c==="blocked"||c==="failed"?"blocked":"unknown",artifact:e.intelligenceRun,blockedStages:l},p={status:"not-applicable",runtime:null,runner:null,existingEvidence:[],prerequisites:[]};if(e$1.intent.category==="test-coverage"){let a=await Promise.all(e$1.projects.map(async n=>({project:n,capability:await c$5(q(e$1.workspacePath,n),t.has(n.runtime)?n.runtime:"unknown")}))),u=a.map(n=>n.capability.status);p={status:u.includes("unsupported")?"unsupported":u.includes("requires-setup")?"requires-setup":"available",runtime:a.length===1?a[0].capability.runtime:[...new Set(a.map(n=>n.capability.runtime))].join(","),runner:a.length===1?a[0].capability.runner:[...new Set(a.flatMap(n=>n.capability.runner?[n.capability.runner]:[]))].join(",")||null,existingEvidence:a.flatMap(n=>n.capability.existingEvidence.map(d=>({project:n.project.name,...d}))).filter((n,d,f)=>f.findIndex(w=>w.project===n.project&&w.path===n.path&&w.sha256===n.sha256)===d).sort((n,d)=>n.project.localeCompare(d.project)||n.path.localeCompare(d.path)),prerequisites:[...new Set(a.flatMap(n=>n.capability.prerequisites))].sort()};}let x=X(e$1.intent),P=x.map(a=>{let u=e$1.projects.map(f=>f$3(e$1.graph,{query:a,projectId:f.name,limit:20,relationsPerEntity:0,minimumTermMatches:2}).entities),n=[],d=new Set;for(let f=0;u.some(w=>f<w.length);f+=1)for(let w of u){let N=w[f];!N||d.has(N.id)||(d.add(N.id),n.push(N));}return n}),E={"test-coverage":["test-suite"],"dependency-security":["package","module"],"release-readiness":["pipeline","deployment","lifecycle-stage"],"defect-repair":["test-suite","lifecycle-stage"],"feature-change":["project","runtime-unit","api","package","module","test-suite"],refactor:["package","module","api","test-suite"],performance:["lifecycle-stage","test-suite","pipeline"],documentation:["document","decision"],"system-understanding":["project","service","api","package","protocol"]},R=new Set(e$1.projects.map(a=>a.name)),S=e$1.graph.entities.filter(a=>a.proofIds.length>0&&(!a.projectId||R.has(a.projectId))&&E[e$1.intent.category].includes(a.kind)).sort((a,u)=>E[e$1.intent.category].indexOf(a.kind)-E[e$1.intent.category].indexOf(u.kind)||a.label.localeCompare(u.label)),s=[],b=new Set,k=a=>{!a||s.length>=20||b.has(a.id)||(b.add(a.id),s.push(a));},A=(e$1.intent.statement.match(/[A-Za-z][A-Za-z0-9+#.-]{1,}/g)??[]).length>=2,T=A?P[0]??[]:[];for(let a of T.slice(0,12))k(a);if(!A)for(let a of S)k(a);for(let a=0;s.length<20&&P.slice(1).some(u=>a<u.length);a+=1)for(let u of P.slice(1))k(u[a]);if(A)for(let a of S)k(a);for(let a of T.slice(12))k(a);let C=s.map(a=>({entityId:a.id,kind:a.kind,label:a.label,proofIds:a.proofIds.slice(0,12)})),g=P[0]?.length??0;return {workspaceIntelligence:m,measurement:p,retrieval:{status:A&&g>=3?"grounded":C.length>0?"partial":"empty",strategy:"deterministic-category-v1",queries:x,anchors:C}}}async function ye(e){let t=h.join(e,f$2);if(!await G.pathExists(t))return {schemaVersion:e$1,generatedAt:new Date(0).toISOString(),activeGoalId:null,goals:[]};let o=await G.readJson(t);return a(o,te,"Goal index"),h$1(o),o}function Pe(e,t,o){let r=e.goals.find(c=>c.id===t.id),i=t.state==="ready-to-plan",l={id:t.id,fingerprint:t.fingerprint,objective:t.intent.statement,category:t.intent.category,state:t.state,lifecycle:r?.lifecycle==="cancelled"?"cancelled":i?"active":"planned",scope:t.scope,createdAt:r?.createdAt??t.generatedAt,updatedAt:o,goalPack:t.artifacts.goalPack,agentHandoff:t.artifacts.agentHandoff,...r?.verifiedGoalId?{verifiedGoalId:r.verifiedGoalId}:{},...r?.repairTransactionId?{repairTransactionId:r.repairTransactionId}:{},...r?.repairTransactionIds?{repairTransactionIds:r.repairTransactionIds}:{}};return {schemaVersion:e$1,generatedAt:o,activeGoalId:l.lifecycle==="active"?t.id:e.activeGoalId,goals:[...e.goals.filter(c=>c.id!==t.id).map(c=>l.lifecycle==="active"&&c.lifecycle==="active"?{...c,lifecycle:"planned",updatedAt:o}:c),l].sort((c,m)=>c.id.localeCompare(m.id))}}async function Me(e$1){let t=b({startPath:h.resolve(e$1.startPath),explicitWorkspacePath:e$1.workspacePath,strict:true,requireProjectMembership:true});if(!t)throw new Error("No canonical Workspai workspace could be resolved.");let o=h.resolve(t.workspacePath);e$1.refresh&&await c({workspacePath:o,strict:false,agent:"generic"});let{model:r,graph:i$1}=await fe(o),l=he({workspacePath:o,invocationProjectPath:t.projectPath,model:r,explicitScope:e$1.scope}),c$4=r.projects.filter(g=>l.projects.includes(g.name));if(c$4.length===0)throw new Error("A Goal Pack requires at least one registered project in its selected scope.");let m=e$1.maxAttempts??5;if(!Number.isInteger(m)||m<1||m>25)throw new Error("--max-attempts must be an integer from 1 to 25.");let p=new Date().toISOString(),x=d(r),P=Z(e$1.intent),E=await we({workspacePath:o,projects:c$4,graph:i$1,intent:P}),R={generatedAt:p,intent:P,workspaceName:r.workspace.name,scope:l,sourceBinding:{model:{artifact:e.model,schemaVersion:f.model,hashAlgorithm:"sha256",hashSemantics:"workspace-model-structural-v1",hash:x,generatedAt:r.generatedAt},graph:{artifact:e.knowledgeGraph,schemaVersion:f.knowledgeGraph,hashAlgorithm:"sha256",hashSemantics:"canonical-json-v1",hash:c$1(i$1),generatedAt:i$1.generatedAt,modelHash:i$1.source.hash,...i$1.source.inputs?.hash?{inputHash:i$1.source.inputs.hash}:{}}},preflight:E,baseline:{projectCount:c$4.length,runtimes:[...new Set(c$4.flatMap(g=>g.runtimeCandidates))].sort(),frameworks:[...new Set(c$4.map(g=>g.framework))].sort(),graph:ke(i$1,l)},maxAttempts:m,consumer:e$1.consumer??"generic"},S={digestCanonical:c$1},{goalPack:s,handoff:b$1}=i(R,S);a(s,Q,"Goal Pack"),a(b$1,Y,"Goal agent handoff");let k=false,A=async()=>{let g=h.join(o,s.artifacts.goalPack),a$1=h.join(o,s.artifacts.agentHandoff),[u,n]=await Promise.all([G.pathExists(g),G.pathExists(a$1)]);if(u!==n)throw new Error(`Goal Pack instance is incomplete and cannot be resumed: ${s.id}`);if(!u)return;let[d,f]=await Promise.all([G.readJson(g),G.readJson(a$1)]);a(d,Q,"Persisted Goal Pack"),a(f,Y,"Persisted goal agent handoff");let w=i({...R,generatedAt:d.generatedAt,sourceBinding:d.sourceBinding},S);if(d.id!==s.id||f.goalId!==s.id||c$1(d)!==c$1(w.goalPack)||c$1(f)!==c$1(w.handoff))throw new Error(`Goal Pack instance failed immutable integrity validation: ${s.id}`);s=d,b$1=f,k=true;};if(e$1.dryRun)await A();else {let g=`.workspai/goals/${s.id}/publication`;await c$2(o,g,async()=>{await A();let a$1=Pe(await ye(o),s,new Date().toISOString());a(a$1,te,"Goal index"),h$1(a$1),await f$1(o,d$1,k?[{relativePath:d$1,payload:s},{relativePath:f$2,payload:a$1}]:[{relativePath:s.artifacts.goalPack,payload:s},{relativePath:s.artifacts.agentHandoff,payload:b$1},{relativePath:d$1,payload:s},{relativePath:f$2,payload:a$1}]);});}let T=[s.artifacts.goalPack,s.artifacts.agentHandoff,d$1,f$2],C={schemaVersion:c$3,result:s.state==="needs-confirmation"?"needs-confirmation":s.state==="blocked"?"blocked":s.state==="needs-evidence"?"needs-evidence":"planned",resolution:{source:t.source,invocationScope:t.projectPath?"project":"workspace"},goalPack:s,agentHandoff:b$1,writtenArtifacts:e$1.dryRun?[]:k?[d$1,f$2]:T,dryRun:e$1.dryRun===true,resumed:k};return a(C,me,"Goal plan result"),C}export{Me as planGoalPack};

package/dist/index.d.ts

@@ -14,12 +14,13 @@ type ProjectGroundingMode = (typeof PROJECT_GROUNDING_MODE_VALUES)[number];
 interface AdoptProjectFilePreimage {
     path: string;
     contents: Buffer | null;
-    preserve?: 'symbolic-link';
+    preserve?: 'symbolic-link' | 'unsafe-parent';
 }
 interface AdoptProjectRollbackSnapshot {
     workspacePath: string;
     projectPath: string;
     files: AdoptProjectFilePreimage[];
+    createdAdapterDirectories: string[];
 }
 
 declare function getPublishedContractVersions(): {
@@ -54,6 +55,8 @@ declare function getPublishedContractVersions(): {
     projectWorkspaceLink: "project-workspace-link.v1";
     projectWorkspaceResolution: "project-workspace-resolution.v1";
     projectContextAgent: "project-context-agent.v1";
+    projectAgentEntry: "workspai.agent-entry.v1";
+    agentBootstrapReceipt: "workspai.agent-bootstrap-receipt.v1";
     doctorProjectEvidence: "doctor-project-evidence-v1";
     doctorWorkspaceEvidence: "doctor-workspace-evidence-v1";
     doctorGraphDiagnosis: "doctor-graph-diagnosis.v1";
@@ -258,6 +261,8 @@ declare function getVersionContract(): {
         projectWorkspaceLink: "project-workspace-link.v1";
         projectWorkspaceResolution: "project-workspace-resolution.v1";
         projectContextAgent: "project-context-agent.v1";
+        projectAgentEntry: "workspai.agent-entry.v1";
+        agentBootstrapReceipt: "workspai.agent-bootstrap-receipt.v1";
         doctorProjectEvidence: "doctor-project-evidence-v1";
         doctorWorkspaceEvidence: "doctor-workspace-evidence-v1";
         doctorGraphDiagnosis: "doctor-graph-diagnosis.v1";
@@ -456,6 +461,8 @@ declare function getGlobalCommandCapabilities(): {
         projectWorkspaceLink: "project-workspace-link.v1";
         projectWorkspaceResolution: "project-workspace-resolution.v1";
         projectContextAgent: "project-context-agent.v1";
+        projectAgentEntry: "workspai.agent-entry.v1";
+        agentBootstrapReceipt: "workspai.agent-bootstrap-receipt.v1";
         doctorProjectEvidence: "doctor-project-evidence-v1";
         doctorWorkspaceEvidence: "doctor-workspace-evidence-v1";
         doctorGraphDiagnosis: "doctor-graph-diagnosis.v1";