@testmuai/kane-cli 0.8.1 → 0.8.2

package/dist/chunk-MXHHMIO2.js

@@ -1,349 +0,0 @@
-import { createRequire } from 'module'; const require = createRequire(import.meta.url);
-import{a as Ve}from"./chunk-KHU7C6EE.js";import{c as We}from"./chunk-IOD3HQVW.js";import{a as ze,b as me}from"./chunk-3Q6WAK6P.js";import{a as te,b as Ne,e as ce,f as le,g as je,h as Ge}from"./chunk-KU6IXFGZ.js";import{a as qe,c as Me,d as Fe,e as de,f as Be}from"./chunk-ZGBSGZZM.js";import{a as Te,b as Ae,c as Ie}from"./chunk-BRHNRCEZ.js";import{a as $e,b as Ee,c as Ce}from"./chunk-BB2W35TW.js";import{a as Oe}from"./chunk-L2TV4G56.js";import{c as Pe}from"./chunk-6KPPGMO2.js";import{a as De,e as Re}from"./chunk-GFKCTYCA.js";import{a as Le}from"./chunk-IMR64OCZ.js";import{a as He,b as Ue}from"./chunk-JZ26R6UL.js";import{b as ye,c as be,d as we,e as re,f as oe,g as ae}from"./chunk-ZPDM6FO7.js";import{a as ie}from"./chunk-L5LI2JF4.js";import{a as _e,b as ne}from"./chunk-IDX3TOPY.js";import{A as G}from"./chunk-TH47OOBV.js";import{f as Se}from"./chunk-DUAXZYAD.js";import{a as ve,e as ke,f as xe}from"./chunk-DBIBROYW.js";import{d as V,e as J}from"./chunk-WXHQYYD5.js";import{a as he}from"./chunk-5EOX4MEY.js";import{mkdirSync as xt,appendFileSync as St,rmdirSync as lt}from"fs";import{randomBytes as Dt}from"crypto";import{dirname as dt,join as fe}from"path";function Ke(t,e){let n=[];for(let i of e??[]){let g=t.resolve(i.ref)?.tip??null;g!==i.cid&&n.push({ref:i.ref,pinned:i.cid,now:g})}return n}import{existsSync as ue,readFileSync as ge,readdirSync as gt}from"fs";import{join as Z}from"path";var Qe=`
-version: 1
-techniques:
-  - id: eqp
-    name: "Equivalence partitioning"
-    applies_hint: "any constrained input"
-    emits: [absolute, forbidden-presence]
-  - id: bva
-    name: "Boundary value analysis"
-    applies_hint: "input has an ordered range or length"
-    emits: [absolute, forbidden-presence]
-  - id: negative
-    name: "Negative / error"
-    applies_hint: "any input or action that can fail"
-    emits: [forbidden-presence]
-  - id: state_flow
-    name: "State / flow"
-    applies_hint: "the AC sits in a multi-step flow"
-    emits: [state-transition]
-  - id: crud
-    name: "CRUD round-trip"
-    applies_hint: "AC touches a persisted resource"
-    emits: [delta, presence, forbidden-presence]
-  - id: auth
-    name: "Auth / permission"
-    applies_hint: "AC is behind a gate or role"
-    emits: [forbidden-presence, presence]
-  - id: api_contract
-    name: "API-contract"
-    applies_hint: "surface is REST/GraphQL"
-    emits: [absolute]
-  - id: concurrency
-    name: "Concurrency / race"
-    applies_hint: "high-risk (money / data-loss) or shared-resource AC"
-    emits: [state-transition, forbidden-presence]
-  - id: idempotency
-    name: "Idempotency / retry"
-    applies_hint: "money or write operations"
-    emits: [delta]
-  - id: i18n
-    name: "i18n / l10n"
-    applies_hint: "AC renders user text or formats numbers/dates/currency"
-    emits: [presence, absolute]
-  - id: a11y
-    name: "a11y"
-    applies_hint: "any rendered surface"
-    emits: [presence, absolute]
-  - id: responsiveness
-    name: "Responsiveness / layout"
-    applies_hint: "rendered surface"
-    emits: [presence, forbidden-presence]
-  - id: empty_state
-    name: "Empty / null / zero state"
-    applies_hint: "list / search / collection AC"
-    emits: [presence]
-  - id: overflow_underflow
-    name: "Overflow / underflow"
-    applies_hint: "numeric or quantity AC (R9: explicit underflow/overflow)"
-    emits: [forbidden-presence]
-  - id: persistence
-    name: "Persistence / refresh"
-    applies_hint: "AC asserts durable state"
-    emits: [absolute]
-  - id: temporal
-    name: "Time / timezone / expiry"
-    applies_hint: "AC involves dates, TTLs, schedules"
-    emits: [state-transition, forbidden-presence]
-  - id: currency
-    name: "Currency / rounding"
-    applies_hint: "money AC"
-    emits: [absolute]
-  - id: pagination
-    name: "Pagination / sort / filter"
-    applies_hint: "list / search AC"
-    emits: [absolute, presence]
-  - id: file_media
-    name: "File / media"
-    applies_hint: "upload surface"
-    emits: [forbidden-presence]
-  - id: notification
-    name: "Notification / async-effect"
-    applies_hint: "AC produces an out-of-band effect (email/SMS/push)"
-    emits: [presence, delta]
-`;var Ye={"web-form":`
-id: web-form
-name: "Web form"
-version: 1
-applies_when: >
-  The AC concerns a data-entry form: input fields, required fields, submit,
-  validation messages.
-candidate_checks:
-  - id: field-validation
-    family: negative
-    measurable_example: "Enter 'abc' in a numeric quantity field \u2192 inline error 'must be a number', value not accepted"
-    emits: forbidden-presence
-  - id: required-fields
-    family: negative
-    measurable_example: "Submit with a required field empty \u2192 submit blocked, field flagged"
-    emits: forbidden-presence
-  - id: formats
-    family: negative
-    measurable_example: "Email without @ rejected; valid accepted"
-    emits: forbidden-presence
-  - id: empty-state
-    family: empty_state
-    measurable_example: "First load: no stale values, placeholders shown"
-    emits: presence
-  - id: error-messages
-    family: negative
-    measurable_example: "Each error is specific and tied to its field"
-    emits: presence
-  - id: a11y
-    family: a11y
-    measurable_example: "Every input has a programmatic label; keyboard-only submit works"
-    emits: presence
-  - id: responsiveness
-    family: responsiveness
-    measurable_example: "No field overlap at 1280/768/375 px"
-    emits: forbidden-presence
-`,"rest-graphql-api":`
-id: rest-graphql-api
-name: "REST / GraphQL API"
-version: 1
-applies_when: >
-  The surface is an HTTP/GraphQL endpoint.
-candidate_checks:
-  - id: response-shape
-    family: api_contract
-    measurable_example: "Body validates against the declared schema"
-    emits: absolute
-  - id: status-codes
-    family: api_contract
-    measurable_example: "GET 200, POST 201, missing 404, bad 400, unauth 401"
-    emits: absolute
-  - id: verbs
-    family: idempotency
-    measurable_example: "PUT is idempotent, POST is not"
-    emits: delta
-  - id: bad-payloads
-    family: negative
-    measurable_example: "Malformed JSON \u2192 400, never 500"
-    emits: absolute
-  - id: idempotency
-    family: idempotency
-    measurable_example: "Same POST with idempotency-key twice \u2192 one effect"
-    emits: delta
-  - id: pagination
-    family: pagination
-    measurable_example: "Page beyond last \u2192 empty list, not error; cursor stable"
-    emits: absolute
-  - id: versioning
-    family: api_contract
-    measurable_example: "v1 contract unchanged after v2 ships"
-    emits: absolute
-  - id: rate-limits
-    family: api_contract
-    measurable_example: "Over the limit \u2192 429 with retry-after"
-    emits: absolute
-`,"mobile-native":`
-id: mobile-native
-name: "Mobile native"
-version: 1
-applies_when: >
-  iOS/Android native surface.
-candidate_checks:
-  - id: interruptions
-    family: state_flow
-    measurable_example: "Incoming call mid-flow \u2192 state preserved on return"
-    emits: state-transition
-  - id: network-transitions
-    family: state_flow
-    measurable_example: "wifi\u2192cellular\u21924G drop: no data loss, graceful retry"
-    emits: state-transition
-  - id: permissions
-    family: negative
-    measurable_example: "Deny camera \u2192 feature degrades, no crash"
-    emits: forbidden-presence
-  - id: orientation
-    family: persistence
-    measurable_example: "Rotate mid-form \u2192 input preserved"
-    emits: absolute
-  - id: deep-links
-    family: state_flow
-    measurable_example: "Cold-start deep link lands on the right screen with auth"
-    emits: state-transition
-  - id: state-persistence
-    family: persistence
-    measurable_example: "Kill + relaunch \u2192 resume where left off"
-    emits: absolute
-  - id: localization
-    family: i18n
-    measurable_example: "Device locale switch reformats and re-translates"
-    emits: presence
-`,"stateful-flow":`
-id: stateful-flow
-name: "Stateful flow"
-version: 1
-applies_when: >
-  Multi-step wizard / checkout / onboarding.
-candidate_checks:
-  - id: valid-transitions
-    family: state_flow
-    measurable_example: "Each step advances only when its precondition is met"
-    emits: state-transition
-  - id: invalid-transitions
-    family: state_flow
-    measurable_example: "Can't jump to step 3 with step 2 incomplete"
-    emits: forbidden-presence
-  - id: back-and-abandon
-    family: state_flow
-    measurable_example: "Back from step 3, then abandon \u2192 no partial commit"
-    emits: forbidden-presence
-  - id: refresh-persistence
-    family: persistence
-    measurable_example: "Reload at step 2 \u2192 still at step 2 with data"
-    emits: absolute
-  - id: resume
-    family: persistence
-    measurable_example: "Return later \u2192 resume the saved flow"
-    emits: absolute
-  - id: double-submission
-    family: idempotency
-    measurable_example: "Double-click submit \u2192 exactly one submission"
-    emits: delta
-`,"data-crud":`
-id: data-crud
-name: "Data CRUD"
-version: 1
-applies_when: >
-  A persisted record.
-candidate_checks:
-  - id: crud-round-trip
-    family: crud
-    measurable_example: "Create \u2192 read shows it \u2192 update \u2192 read shows the change \u2192 delete \u2192 read 404"
-    emits: state-transition
-  - id: retry-safety
-    family: idempotency
-    measurable_example: "Retried create with same key \u2192 one row"
-    emits: delta
-  - id: concurrency-lost-update
-    family: concurrency
-    measurable_example: "Two writers, last must not silently clobber \u2192 conflict surfaced"
-    emits: forbidden-presence
-  - id: delete-cascade
-    family: crud
-    measurable_example: "Delete parent \u2192 children handled per rule"
-    emits: state-transition
-  - id: referential-consistency
-    family: crud
-    measurable_example: "Can't create a child for a missing parent"
-    emits: forbidden-presence
-`,"auth-gated":`
-id: auth-gated
-name: "Auth gated"
-version: 1
-applies_when: >
-  Behind login/role.
-candidate_checks:
-  - id: login-gate
-    family: auth
-    measurable_example: "Anonymous \u2192 redirected to login, not the resource"
-    emits: forbidden-presence
-  - id: role-permission-matrix
-    family: auth
-    measurable_example: "For each role \xD7 action: allowed/denied as specified"
-    emits: absolute
-  - id: cross-user-record
-    family: auth
-    measurable_example: "User A cannot read/edit user B's record by id"
-    emits: forbidden-presence
-  - id: token-session-expiry
-    family: auth
-    measurable_example: "Expired token \u2192 401/redirect, no stale access"
-    emits: forbidden-presence
-  - id: privilege-escalation
-    family: auth
-    measurable_example: "Non-admin cannot reach an admin action by direct URL/API"
-    emits: forbidden-presence
-`,"search-list":`
-id: search-list
-name: "Search / list"
-version: 1
-applies_when: >
-  Search results / list views.
-candidate_checks:
-  - id: pagination
-    family: pagination
-    measurable_example: "First/last/empty page correct; total accurate"
-    emits: absolute
-  - id: sorting
-    family: pagination
-    measurable_example: "Sort asc/desc actually orders; ties stable"
-    emits: absolute
-  - id: filtering
-    family: pagination
-    measurable_example: "Each filter narrows correctly; combined filters AND"
-    emits: absolute
-  - id: empty-state
-    family: empty_state
-    measurable_example: "No results \u2192 friendly empty state, not blank/error"
-    emits: presence
-  - id: invalid-input
-    family: negative
-    measurable_example: "Garbage query \u2192 no crash, sane result"
-    emits: forbidden-presence
-  - id: length-limits
-    family: bva
-    measurable_example: "Max-length query handled"
-    emits: absolute
-  - id: locale
-    family: i18n
-    measurable_example: "Locale-correct collation/casing"
-    emits: presence
-`};var Je=`
-version: 1
-principles:
-  - "Each step is one complete OBJECTIVE the browser agent achieves autonomously \u2014 state the goal and the path, never low-level actions (the agent emits its own actions)."
-  - "One objective (or tightly-related items of one goal) per step; unrelated goals split."
-  - "Verbose path: name site, page, section, panel, control, state \u2014 'On the search results page for Noida, in the filter panel's Budget section, set min to 50L and max to 1Cr'."
-  - "Self-contained: concrete values inline; never 'as defined in the scenario' \u2014 the agent cannot see the graph."
-  - "Browser-only: the agent authors/runs BROWSER tests. Direct API calls and the page's own network traffic ARE in scope; native-app-only behavior, out-of-band email/SMS, backend state with no browser surface are NOT."
-verification:
-  - "Phrase checks against the analyzer that observes them:"
-  - "Visual \u2014 visible text, labels, counts, prices ('verify the price is 29.99', 'the Sold out label is shown')."
-  - "Textual/DOM \u2014 element states/attributes ('the Add button is disabled', 'the placeholder of the search box is \u2026')."
-  - "URL \u2014 'URL contains /checkout', 'redirected to /login'. Title \u2014 'page title contains \u2026'."
-  - "DevTools/Network \u2014 'no API calls returned 5xx', 'the POST /api/login returned 200' (covers direct API calls too)."
-  - "DevTools/Console \u2014 'no console errors'. Performance \u2014 'LCP under 2500ms'. Cookies/localStorage \u2014 'a cookie named session_id exists'."
-  - "Assertions: 'Assert/Verify/Confirm \u2026'. Extractions: 'Store \u2026 as name' \u2014 vague verbs (read/tell/report) do NOT persist values."
-  - "Baselines/deltas are EXTRACTIONS: 'store the result count as baseline_count' BEFORE the action; compare after. Never an abstract 'capture the state'."
-variables:
-  - "Credentials and environment values are {{name}} variables; concrete domain values from the source stay literal."
-  - "A value no evidence supplies (start URL, test account, seed data) is ASKED for \u2014 actual value or a variable name \u2014 never invented."
-pitfalls:
-  - "A test without a starting URL cannot run \u2014 the first step names it."
-  - "'Test the checkout flow' has no end state \u2014 state what done looks like."
-  - "Do not cram many unrelated operations into one step; do not reference data outside the step."
-`;var pt=["presence","forbidden-presence","count","delta","state-transition","absolute","bound","propagation","latency","graded"];function et(t,e){for(let n of t)if(!pt.includes(n))throw new Error(`${e}: emits '${n}' is not an oracle kind`)}function Xe(t,e){let n=ie(t);if(!n||!Array.isArray(n.techniques))throw new Error(`${e}: expected { techniques: [...] }`);for(let i of n.techniques){if(!i.id||!i.name||!i.applies_hint||!Array.isArray(i.emits))throw new Error(`${e}: technique '${i?.id??"?"}' missing id/name/applies_hint/emits`);et(i.emits,`${e}: technique '${i.id}'`)}return n.techniques}function Ze(t,e){let n=ie(t);if(!n||!n.id||!n.name||!n.applies_when||!Array.isArray(n.candidate_checks))throw new Error(`${e}: profile missing id/name/applies_when/candidate_checks`);for(let i of n.candidate_checks){if(!i.id||!i.family||!i.measurable_example||!i.emits)throw new Error(`${e}: candidate_check '${i?.id??"?"}' missing id/family/measurable_example/emits`);et([i.emits],`${e}: check '${i.id}'`)}return n}function tt(t){let e=new Map(Xe(Qe,"packaged techniques").map(i=>[i.id,i])),n=Z(t,"design","techniques.yaml");if(ue(n))for(let i of Xe(ge(n,"utf8"),n))e.set(i.id,i);return[...e.values()]}function st(t){let e=new Map(Object.entries(Ye).map(([i,g])=>[i,Ze(g,`packaged profile '${i}'`)])),n=Z(t,"design","profiles");if(ue(n))for(let i of gt(n).filter(g=>g.endsWith(".yaml")||g.endsWith(".yml")).sort()){let g=Ze(ge(Z(n,i),"utf8"),Z(n,i));e.set(g.id,g)}return[...e.values()]}function it(t){let e=Z(t,"design","runner-grammar.yaml");return ue(e)?ge(e,"utf8"):Je}function ee(t,e){return!t.superseded.has(e)}function pe(t,e,n){return{cid:e,logical_id:t.nameOf.get(e)??null,content:n}}async function nt(t,e,n,i,g){let r=await Ne(t,"search_similar",{text:e,label:n,k:i},g);return r.ok&&Array.isArray(r.result)?r.result:[]}async function rt(t,e,n={}){let i=G(t),g=i.resolve(e);if(!g)throw new Error(`assembleDesignContext: unknown use-case '${e}' (run designGate first)`);let r=g.tip,x=i.getNode(r);if(!x||x.label!==V.USECASE)throw new Error(`assembleDesignContext: '${e}' is not a use-case (run designGate first)`);let O=i.derivesInto(r).map(d=>({source_id:d.props.source_id??null,anchor:d.props.anchor??null})),S=[],E=new Set;for(let{cid:d,content:k}of i.byLabel(V.SCENARIO))ee(i,d)&&i.edgesFrom(d).some(y=>y.type===J.BELONGS_TO&&y.dst===r)&&(S.push(pe(i,d,k)),E.add(d));let D=[];for(let{cid:d,content:k}of i.byLabel(V.AC)){if(!ee(i,d))continue;let y=i.edgesFrom(d).find(T=>T.type===J.SCOPED_TO);!y||y.dst!==r&&!E.has(y.dst)||D.push({...pe(i,d,k),scoped_to:y.dst})}let w=Array.isArray(x.content.criteria)?x.content.criteria:[],_=[x.content.title,x.content.description,...w].filter(Boolean).join(`
-`),F=(await nt(i,_,V.SCENARIO,10,n.embedSearch)).filter(d=>!E.has(d.cid)),B=[],R=new Set,p=[],f=[r],v=new Set([r]);for(;f.length>0;){let d=f.shift();for(let k of i.edgesFrom(d)){if(k.type!==J.DEPENDS_ON||i.nodeLabel.get(k.dst)!==V.USECASE)continue;let y=i.tipOf(k.dst);v.has(y)||(v.add(y),p.push(y),f.push(y))}}for(let d of p){let k=`depends_on ${i.nameOf.get(d)??d.slice(0,19)}`;for(let{cid:y}of i.byLabel(V.SCENARIO))if(ee(i,y)&&i.edgesFrom(y).some(T=>T.type===J.BELONGS_TO&&T.dst===d))for(let T of i.edgesInto(y)){if(T.type!==J.AUTOMATES||!ee(i,T.src)||R.has(T.src))continue;R.add(T.src);let Q=String(i.getNode(T.src)?.content.title??"");B.push({cid:T.src,logical_id:i.nameOf.get(T.src)??null,title:Q,via:k})}}for(let d of await nt(i,_,V.TEST,5,n.embedSearch)){let{cid:k,title:y}=d;R.has(k)||(R.add(k),B.push({cid:k,logical_id:i.nameOf.get(k)??null,title:y??"",via:"similar"}))}let P=i.byLabel(V.STYLENOTE).filter(d=>ee(i,d.cid)).sort((d,k)=>d.cid<k.cid?-1:1).slice(0,5).map(d=>`${String(d.content.statement)} [${String(d.content.learned_from_kind)}]`);return{usecase:pe(i,r,x.content),cites:O,committed_acs:D,existing:{scenarios:S,reuse_candidates:F},import_candidates:B,style_notes:P,techniques:tt(t),profiles:st(t),runner_grammar:it(t),budget:{...n.max!=null?{max_pairs:n.max}:{},...n.strength!=null?{strength_override:n.strength}:{}},design_of:(()=>{let d=He(i,r);return d?{engine:d.engine,seq:d.seq}:null})()}}function ot(t){let e=n=>{if(Array.isArray(n))return n.map(e);if(n!==null&&typeof n=="object"){let i={};for(let g of Object.keys(n).sort())i[g]=e(n[g]);return i}return n};return JSON.stringify(e(t),null,1)}import{basename as ht,dirname as _t,resolve as yt}from"path";var ft=oe,bt=new Set(["narrative","acs","scenarios","tests","exercises","gaps","scoped_to_repoints","judgements","phase"]);function wt(t){let e=/strength=(\d+)\s*(?:—|-)?\s*(.*)/.exec(t??"");return e?{strength:Number(e[1]),reason:e[2]||t||""}:{strength:2,reason:t??""}}function vt(t,e,n=new Set,i=0){return ft(e,ae(t),n,i)}function kt(t,e,n,i){let g=e.scenarios?.find(w=>w.temp_ref===n.automates)??(()=>{let w=t.resolve(n.automates),_=w?t.getNode(w.tip)?.content:void 0;return _?{title:String(_.title??""),intent:String(_.intent??""),technique_notes:String(_.technique_notes??"")}:{}})(),r=[...(e.acs??[]).map(w=>({ref:w.temp_ref,text:w.text})),...n.verifies.filter(w=>!(e.acs??[]).some(_=>_.temp_ref===w)).map(w=>{let _=t.resolve(w);return{ref:w,text:_?String(t.getNode(_.tip)?.content.text??""):""}})],{test_md:x,objectives_yaml:O}=we({title:n.title,steps:n.steps,check:n.check,check_prose:n.check_prose,reuses:n.reuses},{title:g.title,intent:g.intent},r),S=re(vt(t,x)),E=n.check,D={technique:g.technique_notes??"",profile_family:e.judgements?.find(w=>w.kind==="profile_family"&&(w.target===n.temp_ref||w.target===n.automates))?.rationale??"unspecified",anchor:E.verified_against,expected_how:e.judgements?.find(w=>w.kind==="expected_how"&&w.target===E.verified_against)?.rationale??`expected_mode: ${E.expected_mode??"inferred"}`,combinatorial:wt(g.technique_notes),surface_state:"absent",deferred_bindings:E.expected_mode==="runtime-derived"?1:0};return i.push({definitionId:S,rationale:D,anchorRef:E.verified_against,tempRef:n.temp_ref}),{temp_ref:n.temp_ref,title:n.title,automates:n.automates,verifies:n.verifies,check:n.check,definitionId:S,test_md_blob:x,objectives_blob:O,...n.reuses?.length?{reuses:n.reuses}:{},...n.surface_required!==void 0?{surface_required:n.surface_required}:{}}}function at(t){let e=0,n=t.forceScope??null;return{terminalEventType:"design",async onProposalEvent(i){let g=o=>t.steer?(t.steer(`[auto-repair] ${o} \u2014 please re-finalize with this fixed.`),{proposal:null,error:null}):{proposal:null,error:o};if(i==null||typeof i!="object")return g("finalize_design payload is not an object");let r=i,x=Object.keys(r).filter(o=>!bt.has(o));if(x.length>0)return g(`finalize_design carries ungated/unknown section(s): ${x.join(", ")} \u2014 mintable here: acs, scenarios, tests (+gaps)`);let O=new Map;for(let o of r.tests??[]){let u=O.get(o.automates);if(u)return g(`strict 1:1 violated in-payload: ${u} and ${o.temp_ref} both automate ${o.automates}`);O.set(o.automates,o.temp_ref)}let S=G(t.contextDir);t.force&&!t.resuming&&e===0&&n===null&&(n=ze(S,t.ucRef));let E=S.resolve(t.ucRef),D=E?String(S.getNode(E.tip)?.content.risk??"med"):"med",w=[],_=new Set([t.ucRef,E?.cid,E?.tip].filter(Boolean)),F=o=>{if(_.has(o))return!0;let u=S.resolve(o);return u!=null&&(_.has(u.cid)||_.has(u.tip))},B;try{B={...r.acs?.length?{acs:r.acs.map(o=>({temp_ref:o.temp_ref,text:o.text,kind:o.kind,risk:o.risk??D,...o.expected_answer?{expected_answer:o.expected_answer}:{},...o.scoped_to&&!F(o.scoped_to)?{scope:{type:"scenario",ref:o.scoped_to}}:{}}))}:{},...r.scenarios?.length?{scenarios:r.scenarios}:{},...r.tests?.length?{tests:r.tests.map(o=>kt(S,r,o,w))}:{},...r.exercises?.length?{exercises:r.exercises}:{},...r.gaps?.length?{gaps:r.gaps}:{},...r.scoped_to_repoints?.length?{scoped_to_repoints:r.scoped_to_repoints}:{},...r.judgements?.length?{judgements:r.judgements}:{}}}catch(o){return g(o instanceof Error?o.message:String(o))}let R=r.phase??(r.tests?.length?"tests":r.scenarios?.length?"scenarios":r.acs?.length?"acs":"design"),p=(o,u={})=>({contextDir:t.contextDir,graph:o,ucRef:t.ucRef,sections:B,by:t.by,phase:R,...u,...t.templateVersion?{templateVersion:t.templateVersion()}:{},...t.engine?{engine:t.engine}:{},...n?.length?{forceScope:n}:{},...t.because?{reason:t.because}:{},finalizeTestBody:(()=>{let A=new Map((B.tests??[]).map(I=>[I.temp_ref,I])),C=new Map,Y=(I,q,H)=>{let j=A.get(I);if(!j?.test_md_blob)return null;let U=C.get(I);if(U!==void 0)return U;if(H.has(I))return j.test_md_blob;H.add(I);let z=new Map;for(let W of j.reuses??[]){Y(W,q,H);let b=q(W);b!==null&&b!==W&&z.set(W,b)}let N=j.verifies.map(q).filter(W=>W!==null),K=ye(be(j.test_md_blob,z),N);return C.set(I,K),K};return(I,q)=>{if(!I.test_md_blob)return null;let H=Y(I.temp_ref,q,new Set)??I.test_md_blob;if(H===I.test_md_blob)return null;let j=U=>{for(let z of A.keys())if(q(z)===U){let N=Y(z,q,new Set);if(N!==null)return{body:N,cycleKey:`batch:${U}`,next:j}}return ae(S)(U)};return{test_md_blob:H,definitionId:re(oe(H,j))}}})()}),f;if(t.protocol){let o=t.generationTicket,u=await Te(t.protocol,{verb:"design",ucTargets:[{ref:t.ucRef}],newBuCandidates:[],sourcePins:[],readBasis:S.latestHash,...o?{generationTicket:o}:{}},A=>{let C=me(p(A.graph,{eventIds:A.eventIds("design",1),sid:A.sid,...o&&!t.generationStamped?{generationTicket:o}:{}}));return C.errors!==null?{errors:C.errors}:{result:C,record:C.record}});u.ok&&"result"in u?(f=u.result,o&&!t.generationStamped&&(t.generationStamped=!0,t.generationTicket={...o,expected_prev_gen:o.next_gen})):u.ok?f={record:null,errors:null,minted:{},logicalIds:{},superseded:[],warnings:["commit already applied (recommit)"],finalizedTests:{}}:f={record:null,errors:u.kind==="validation"?u.errors:u.kind==="contended"?[{code:u.err.code,detail:`${t.ucRef} is held by ${u.err.holder?.owner_sid??"another session"}${u.err.holder?.alive?" (live)":" (stale)"} \u2014 try another use-case or wait for it to free`}]:u.kind==="drifted"?u.asks.map(C=>({code:"DRIFTED",detail:C.detail})):[{code:"UNSETTLED",detail:`concurrent activity kept moving the store (${u.attempts} attempts) \u2014 retry when the store is quieter`}],minted:{},logicalIds:{},superseded:[],warnings:[],finalizedTests:{}}}else f=me(p(S));if(f.errors)return g("design commit failed: "+f.errors.map(o=>`${o.code}: ${o.detail}`).join("; "));let v=f.warnings.filter(o=>o.includes("\u2014 committed anyway; approve"));for(let o of f.warnings)(!v.includes(o)||v.length===1)&&t.note(`warning: ${o}`);v.length>1&&t.note(`warning: ${v.length} test link(s) refer to items still awaiting approval \u2014 saved anyway; review and approve those items in chat or via kane-cli context review`);let P=(o,u)=>o?`${o} ${u}${o>1?"s":""}`:null,d=[P(r.acs?.length,"AC"),P(r.scenarios?.length,"scenario"),P(r.tests?.length,"test"),P(r.gaps?.length,"gap")].filter(Boolean);t.aliases?.(Object.entries(f.minted).map(([o,u])=>({ref:o,cid:u,...f.logicalIds[o]?{id:f.logicalIds[o]}:{}})));{let o=`saved ${d.join(" \xB7 ")||"judgements/wiring"} as drafts`;(t.commitLine??t.note)(o)}let k=G(t.contextDir);t.onCommitted?.(k);for(let o of w){let u=f.logicalIds[o.anchorRef]??f.minted[o.anchorRef];Ve(t.contextDir,f.finalizedTests[o.tempRef]??o.definitionId,{...o.rationale,anchor:u??o.rationale.anchor})}try{let o=Object.values(f.minted).filter(u=>k.getNode(u)?.label==="test");if(o.length>0){let u=_t(yt(t.contextDir)),A=We({graph:k,cids:o,cwd:u});A.wrote.length>0&&t.note(`\u2692 wrote ${A.wrote.map(C=>ht(C.path)).join(" \xB7 ")}`);for(let C of A.refused)t.note(`warning: could not create the test file for ${C.id} \u2014 ${C.reason}`)}}catch(o){t.note(`warning: the design was saved, but its test file could not be created (${o instanceof Error?o.message:String(o)})`)}t.event?.({type:"commit",acs:r.acs?.length??0,scenarios:r.scenarios?.length??0,tests:r.tests?.length??0,gaps:r.gaps?.length??0,warnings:f.warnings.length,minted:Object.entries(f.minted).map(([o,u])=>({temp_ref:o,cid:u,...f.logicalIds[o]?{logical_id:f.logicalIds[o]}:{}}))}),e+=1,n!==null&&(n=f.forceScopeRemaining??n,t.onForceScope?.(n));let y=Oe({verb:"design",commitN:e,ucRef:t.ucRef,phase:R,committed:Object.entries(f.minted).map(([o,u])=>({temp_ref:o,cid:u,...f.logicalIds[o]?{logical_id:f.logicalIds[o]}:{}})),warnings:f.warnings},k),T=y.event.parity?.missing??[],Q=!!r.tests?.length&&T.length===0;return{proposal:f,error:null,receipt:y,...Q?{sessionComplete:Q}:{}}}}}function ct(t,e){return{type:"run_config",version:1,session_id:e.session_id,mode:e.mode,source:{source_id:`design:${t.usecase.logical_id??e.ucCid.slice(0,19)}`,source_cid:e.ucCid,kind:"design_context",numbered_text:ot({...t,session_mode:e.mode})},existing_use_cases:[],read_basis:e.readBasis,max_free_text_rounds:2,graph_reads:!0,verb:"design",chat:!0,design_budget:t.budget,topology:e.topology}}var mt=Symbol("design-out-tee");function Rt(t,e,n,i){return{terminalEventType:"design",async onProposalEvent(g){let r=g??{},x=["acs","scenarios","tests","gaps"].map(O=>r[O]?.length?`${r[O].length} ${O}`:null).filter(Boolean).join(" \xB7 ");return n?.("plan_payload",{payload:r}),t(`plan: finalize_design \u2014 ${x||"wiring/judgements only"} (nothing committed${i?`; full payload: ${te(i)}`:""})`),e?.({type:"plan",payload:r}),{proposal:r,error:null}}}}async function Rs(t,e){let n=G(e.contextDir),i=null,g=null,r=t.useCase;if(t.resume){try{{let m=await Be(e.contextDir,t.resume,n,{deps:{onWarn:h=>e.out(`note: ${h}`)}});g=m,i=m.handle,m.drift.length>0&&(e.out(`note: sources changed since the pause: ${m.drift.map(h=>h.subject).join(", ")} \u2014 the design continues against the current versions`),e.emit?.({type:"stale_basis",sources:m.drift.map(h=>h.subject)}))}}catch(m){if(m instanceof _e||m instanceof de)return e.out(`error: ${m.message}`),e.emit?.({type:"error",message:`error: ${m.message}`}),m instanceof de||m.code==="SESSION_MISSING"||m.code==="SESSION_EXPIRED"?2:1;throw m}let s=i.state,c=qe(s.verb,"design",t.resume);if(c)return e.out(c.message),e.emit?.({type:"error",message:c.message,code:c.code}),i.release(),2;if(r&&s.use_case&&r!==s.use_case){let m=`session ${t.resume} was designing ${s.use_case}; --use-case ${r} RETARGETS it`;if(!(t.confirmRetarget?await t.confirmRetarget(`${m} \u2014 continue with the new target?`):!1))return e.out(`error: ${m} \u2014 resume without --use-case to continue ${s.use_case}, or start a fresh session on ${r}`),e.emit?.({type:"error",code:"RETARGET_MISMATCH",message:m}),i.release(),2}if(r=r??s.use_case,s.uc_tip&&r){let m=n.resolve(r)?.tip;if(m&&m!==s.uc_tip){let h=`the use-case changed since the pause (${s.uc_tip.slice(0,19)}\u2026 \u2192 ${m.slice(0,19)}\u2026)`;if(!(t.confirmRetarget?await t.confirmRetarget(`${h} \u2014 re-ground and continue against the new version?`):!1))return e.out(`error: ${h} \u2014 resume interactively to re-ground, or abandon this session`),e.emit?.({type:"error",code:"UC_TIP_MOVED",message:h}),i.release(),2;e.emit?.({type:"stale_basis",usecase:r})}}let l=Ke(n,s.target_pins);if(l.length>0){let m=`items this session pinned have changed since it paused: ${l.map($=>`${$.ref}${$.now===null?" (now gone)":""}`).join(", ")}`;if(!(t.confirmRetarget?await t.confirmRetarget(`${m} \u2014 re-ground and continue?`):!1))return e.out(`error: ${m} \u2014 resume interactively to re-ground, or abandon`),e.emit?.({type:"error",code:"TARGET_PIN_MOVED",message:m}),i.release(),2;i.save({target_pins:(s.target_pins??[]).map($=>({ref:$.ref,cid:n.resolve($.ref)?.tip??$.cid}))})}let a=[...new Set([...i.state.held_receipts??[],...g?.view.kane?.held_receipts??[]])];if(a.length>0)if(e.chat?.holdReceipt)for(let m of a)e.chat.holdReceipt(m);else e={...e,initialMessage:[a.join(`
-
-`),e.initialMessage].filter(Boolean).join(`
-
-`)};if(!r)return e.out(`error: session ${t.resume} predates use-case persistence \u2014 re-supply --use-case <ref>`),e.emit?.({type:"error",message:`error: session ${t.resume} predates use-case persistence \u2014 re-supply --use-case <ref>`}),i.release(),2}let x=t.resume?void 0:t.phase,O=!1;if(x!==void 0){let{checkPhaseEntry:s,phaseEntryCmd:c,phaseLadderFor:l}=await import("./phase-seed-VFHIH6FL.js");O=l(e.contextDir,n,r).length>0;let a=s(e.contextDir,n,r,x);if(!a.ok&&a.code==="UNKNOWN_PHASE")return e.out(`error: ${a.message}`),e.emit?.({type:"error",code:"UNKNOWN_PHASE",message:a.message}),i?.release(),2;if(!a.ok&&a.code==="PHASE_ORDER"){let m=t.askPhaseEntry?await t.askPhaseEntry({message:a.message,earliest:a.earliest}):"cancel";if(m==="earliest")e.out(`starting at ${a.earliest} instead (${a.missing.join(", ")} not committed yet)`),x=a.earliest;else if(m==="proceed")e.out(`note: entering at ${x} with ${a.missing.join(", ")} uncommitted \u2014 proceeding on your say-so`),e.emit?.({type:"phase_entry_override",phase:x,missing:a.missing});else{let h=(t.mode??"interactive")==="agent",$=c(r,a.earliest,h);return e.out(`error: ${a.message}`),e.emit?.({type:"error",code:"PHASE_ORDER",message:a.message,next:[{cmd:$,why:`${a.earliest} is the earliest uncommitted phase for ${r}`,title:`Start at ${a.earliest}`}]}),i?.release(),2}}}let S=!!(t.force||i?.state.force),E=!!(t.resume&&i),D=Ue(n,r,S||E||O);if(!D.ok){let s=(t.mode??"interactive")==="interactive";if(D.wall&&s&&t.askDesignEntry){let{captureForceScope:c}=await import("./design-committer-VYT6NU3T.js"),l=c(n,r).length,a=await t.askDesignEntry({wall:D.wall.kind,message:D.message,display:D.wall.display,impactPairs:l});if(a.pick==="redesign"||a.pick==="proceed"){if(!a.because.trim())return e.out("a redesign needs a reason (--because) \u2014 nothing executed"),i?.release(),2;e.out(a.pick==="redesign"?`redesigning ${D.wall.display} (${l} pair(s) superseded) \u2014 because: ${a.because.trim()}`:`proceeding against the stale design (noted) \u2014 because: ${a.because.trim()}`),t={...t,force:!0,because:t.because??a.because.trim()},S=!0}else return a.pick==="view"?(e.out(`view the existing design: kane-cli context view ${D.wall.display}`),i?.release(),0):a.pick==="refresh"?(e.out(`refresh it first: kane-cli maintain evolve ${D.wall.display}`),i?.release(),0):(e.out("nothing executed \u2014 list use-cases: kane-cli context list"),i?.release(),0)}else{e.out(`design: ${D.message}`);let c=D.wall&&t.mode==="agent"?[{cmd:`kane-cli context view ${D.wall.display}`,why:"view the existing design",title:"View the design"},...D.wall.kind==="designed-stale"?[{cmd:`kane-cli maintain evolve ${D.wall.display}`,why:"the use-case moved since the design \u2014 evolve refreshes it",title:"Evolve the design"}]:[],{cmd:`kane-cli design tests --use-case ${D.wall.display} --force --mode agent`,why:"redesign \u2014 supersedes the live scenario+test pairs",title:"Redesign"}]:void 0;return e.emit?.({type:"gate_refused",message:D.message,...c?{next:c}:{}}),i?.release(),D.code}}if(e.preflightTurn){let s=await e.preflightTurn();if(!s.ok)return e.out(s.message??"error: turn-endpoint preflight failed"),e.emit?.({type:"error",message:s.message??"error: turn-endpoint preflight failed",code:"PREFLIGHT"}),i?.release(),2}let w={contextDir:e.contextDir,resolveAlias:s=>Ae(s,{env:process.env,auth:e.auth}),embed:(s,c)=>Ie(s,c,{env:process.env,auth:e.auth})};e.chat?.setWorking?.("assembling context\u2026");let _=await rt(e.contextDir,r,{max:t.max,strength:t.strength,embedSearch:w});if(t.priorDesign!==void 0&&(_.prior_design=t.priorDesign),t.changeDelta!==void 0&&(_.change_delta=t.changeDelta),t.because&&(_.because=t.because),x!==void 0){let{buildPhaseSeed:s}=await import("./phase-seed-VFHIH6FL.js"),c=s(e.contextDir,n,r,x);_.prior_design===void 0&&c.priorDesign!==void 0&&(_.prior_design=c.priorDesign),_.entry_phase=x,c.phaseLadder.length>0&&(_.phase_ladder=c.phaseLadder)}let F=e.now?.()??new Date,B=`${F.toISOString().replace(/[-:]/g,"").slice(0,15)}-${Dt(2).toString("hex")}`,R=t.mode??"interactive",p=g?{...g.spawnConfig,mode:R}:ct(_,{session_id:t.resume??`design-${B}`,mode:R,ucCid:_.usecase.cid,readBasis:n.latestHash,topology:Le("design")}),f={current:null};if(p.resume&&"schema"in p.resume){let s=p.resume.binding?.template_version;typeof s=="string"&&(f.current=s)}t.plan?p.chat=!1:p.chat=!0;let v=e.telemetry?.enabled?e.telemetry:void 0,P=v?he(v.ids.context_instance_id??null,"design",v.ids.session_id):fe(e.contextDir,"logs",`design-${B}.log`);xt(dt(P),{recursive:!0}),e.out(`trace: ${te(P)}`),e.emit?.({type:"run_start",mode:R,trace:P,use_case:r,...v?{session:v.ids.session_id}:{}});let d=(s,c,l)=>{try{St(P,JSON.stringify({ts:new Date().toISOString(),level:s==="error"?"error":"info",run_id:v?.ids.operation_id,...v?{user_session_id:v.ids.session_id}:{},kind:s,session_id:l,data:c})+`
-`)}catch{}v?.wireTrace(s,c,l)};{let s=e.out;if(s[mt]!==!0){let c=l=>{d("transcript",{line:l}),s(l)};c[mt]=!0,e.out=c}}if(t.resume&&i){g||(p.resume={agent_state:i.state.agent_state}),e.out(`resuming design session ${t.resume}`),i.state.assumed.length>0&&e.out(`note: ${i.state.assumed.length} default(s) were assumed while you were away \u2014 kane-cli context sessions show ${t.resume} lists them`);try{let{readRecords:s}=await import("./records-IOZTZUZV.js"),c=s(e.contextDir).records.filter(l=>l.sid===t.resume).map(l=>l.design_phase).filter(l=>l!=null&&typeof l.phase=="string");if(c.length>0){let l=c.map(m=>`${m.phase}${m.completeness==="partial"?" (partial)":""}`).join(" \u2192 "),a=`[kane] durable record for this session (${t.resume}) on ${r}: design phases already COMMITTED \u2014 ${l}. Those finalizes landed; do not re-send them. Continue from the next uncommitted phase, or finish if the design is complete.`;e={...e,initialMessage:[e.initialMessage,a].filter(Boolean).join(`
-
-`)}}}catch{}t.message&&(e={...e,initialMessage:[e.initialMessage,t.message].filter(Boolean).join(`
-
-`)})}let k=null,y={current:n},T={detach:null},Q=()=>{let s=T.detach;T.detach=null,s&&s()},o=(s,c)=>{let l=i;if(!l)return{};let a=s.ask,m=je({contextDir:s.contextDir,cwd:dt(s.contextDir),handle:l,note:h=>s.chat?s.chat.note(h):s.out(h),graphSlot:c,...s.now?{now:s.now}:{}});if(s.chat?.attachIngest){let h=s.chat;T.detach=h.attachIngest(async $=>{try{l.save({ingest_registry:le(l.state.ingest_registry,$,s.now?.()??new Date)});let L=await m({id:`attach-${l.state.sid}-${(l.state.ingest_registry??[]).length}`,ref:$,purpose:null});return L.ok?(h.deferBatch({source_id:L.result.source_id,cid:L.result.cid}),{ok:!0}):{ok:!1,error:L.error.message}}catch(L){return{ok:!1,error:L instanceof Error?L.message:String(L)}}})}return{ask:async h=>{let $=await a(h);if(Array.isArray($)){let L=$.filter(M=>{if(M.free_text==null||M.free_text.trim()==="")return!1;let se=h.find(ut=>ut.id===M.id);return M.selected_index!=null&&se?.options[M.selected_index]?.input===!0}).map(M=>M.free_text.trim());if(L.length>0){let M=l.state.ingest_registry;for(let se of L)M=le(M,se,s.now?.()??new Date);l.save({ingest_registry:M})}}return $},ingest:m}};e.nested||e.chat?.attachOnCommitted?.(s=>{y.current=s});let u="";if(e.chat&&!t.plan&&!e.nested){let s=Pe({contextDir:e.contextDir,graph:G(e.contextDir),sessionStamp:p.session_id,by:e.by??{kind:"human",id:"owner"}});s.errors===null||s.errors[0]?.code==="CONV_SOURCE_EXISTS"?(u=s.sourceId,e.chat.attachConversationSource?.(u),y.current=G(e.contextDir)):e.out(`warning: notes you add in chat can't be saved to the context this session (${s.errors[0]?.detail})`)}let A=G(e.contextDir),C;if(!t.plan){let s=Ee(A,r);if(E&&s!==null&&s.live){let c=A.resolve(r);C={uc_root:$e(A,c.cid),next_gen:s.gen,expected_prev_gen:s.gen}}else{let c=Ce(A,r,{...S?{force:!0}:{},because:t.because??(S?"forced redesign (--force)":void 0)});if("error"in c)return e.out(`design: ${c.error.detail}`),e.emit?.({type:"gate_refused",message:c.error.detail,code:c.error.code}),i?.release(),2;C=c}}let Y=ke(e.contextDir,p.session_id),I=null,q=()=>{try{I?.release()}catch{}};if(!t.plan)try{I=Y.acquire([xe(A,r).key],{hold:"session",verb:"design"})}catch(s){if(s instanceof ve&&s.code==="UC_HELD"){let c=s.holder,l=`design: ${r} is being designed by another session${c?.alive===!1?` \u2014 that session looks stopped; resume it with kane-cli design tests --resume ${c?.owner_sid??"<session>"}`:""} \u2014 pick another use-case (kane-cli design tests) or wait for it to finish`;return e.out(l),e.emit?.({type:"error",code:"UC_HELD",message:l}),i?.release(),2}throw s}let H={contextDir:e.contextDir,rootSid:p.session_id,locks:Y,probe:{batchSimilar:async()=>({hits:[],degraded:!1,probeBasis:null}),recheckLocal:()=>({hits:[],uncachedNewNodes:[]})}},j=!t.plan&&R!=="ci",U=()=>Object.fromEntries((n.resolve(r)?n.edgesInto(n.resolve(r).tip):[]).filter(s=>s.type==="DERIVES"&&typeof s.props.source_id=="string").map(s=>[String(s.props.source_id),n.heads.get(String(s.props.source_id))??null])),z=!1;j&&!i&&(z=!0,i=ne(e.contextDir,{sid:p.session_id,mode:"agent",created_at:F.toISOString(),expires_at:new Date(F.getTime()+1440*60*1e3).toISOString(),agent_state:{schema:2,items:[],provider_state:""},pending:{questions:[],proposals:[]},read_basis:U(),assumed:[],corpus_cursor:{remaining:[]},conv_source:u,target_pins:n.resolve(r)?[{ref:r,cid:n.resolve(r).tip}]:[],verb:"design",use_case:r,...n.resolve(r)?.tip?{uc_tip:n.resolve(r).tip}:{},...S?{force:!0}:{},...v?{user_session_id:v.ids.session_id}:{}}));let N;if(j&&i){let{resume:s,...c}=p;Re(e.contextDir,p.session_id,{schema:De,kind:"base",sid:p.session_id,verb:"design",mode:R,created_at:F.toISOString(),run_config:c,conv_source:u||i.state.conv_source||"",...r?{use_case:r}:{},...n.resolve(r)?.tip?{uc_tip:n.resolve(r).tip}:{},store_watermark:Se(e.contextDir)}),p.checkpoints=!0,t.resume&&d("resume_kind",{kind:g?g.view.pointer===null?"bare-base":g.view.pointer.at==="final"?"pause":"crash":"v1-shim"},p.session_id);let l=g?0:i.state.checkpoint?.seq??0,a=i;N=Fe({contextDir:e.contextDir,handle:a,seqBase:()=>l,peekHeldReceipts:()=>e.chat?.peekHeldReceipts?.()??[],readBasis:()=>U(),corpusCursor:()=>({remaining:[]}),onSoftCap:h=>e.out(h),onStat:h=>d("ckpt_stat",h,p.session_id),...e.now?{now:e.now}:{}});let m=N;N={...m,persist:h=>{let $=h.binding?.template_version;return typeof $=="string"&&$&&(f.current=$),m.persist(h)}}}let K=()=>{if(!i)return;let s=i.state.checkpoint;if(s){let c=R!=="interactive"?` --mode ${R}`:"";e.out(`session ${i.state.sid} kept its last checkpoint (seq ${s.seq}, ${s.ts}) \u2014 resume with: kane-cli design tests --resume ${i.state.sid}${c}`),i.release()}else if(z){try{i.complete()}catch{i.release()}try{lt(fe(e.contextDir,"sessions"))}catch{}}else i.release();i=null},W=t.plan?Rt(e.out,e.emit,d,P):at({templateVersion:()=>f.current,contextDir:e.contextDir,ucRef:r,by:{kind:"ai",id:"design-agent"},force:S,engine:"design@1",note:s=>e.chat?e.chat.note(s):e.out(s),commitLine:s=>e.chat?e.chat.ledger({kind:"commit",ok:!0,line:s}):e.out(s),steer:e.chat?s=>e.chat.submit(s):void 0,event:e.emit,resuming:E,...i?.state.force_scope?.length?{forceScope:i.state.force_scope}:{},onForceScope:s=>{k=s},...t.because?{because:t.because}:{},aliases:e.chat?s=>e.chat.registerAliases?.(s):void 0,onCommitted:s=>{y.current=s},protocol:H,...C?{generationTicket:C}:{},...E?{generationStamped:!0}:{}});e.chat||(d("design_budget",{max_pairs:_.budget.max_pairs??null,strength:_.budget.strength_override??null}),e.out(`designing: ${_.usecase.logical_id??r}`)),e.chat?.setWorking?.(`designing ${_.usecase.logical_id??r}\u2026`);let b;try{b=await ce(p,{...e,graphSlot:y,...o(e,y),...N?{checkpoint:N}:{}},new Map,n,d,W)}catch(s){throw d("error",{message:s instanceof Error?s.message:String(s),stack:s instanceof Error?s.stack:void 0},p.session_id),K(),s}finally{e.chat?.setWorking?.(null),Q()}if(b.errorCode==="binding_mismatch"&&g){let s=await e.ask([{id:"binding-mismatch",text:"this session's saved conversation is no longer accepted by the service \u2014 start the conversation fresh (committed work is kept), or stop and keep the session?",risk:"high",rationale:"the service refused the saved conversation on the first turn after resume",options:[{label:"start fresh",detail:"continue with a fresh conversation \u2014 earlier answers may be re-asked"},{label:"stop",detail:"stop here; the session stays resumable"}],recommended_index:1,allow_free_text:!1}]);if((Array.isArray(s)?s.find(a=>a.id==="binding-mismatch"):void 0)?.selected_index!==0){let a=`resume abandoned: binding mismatch on session ${p.session_id} \u2014 the session is preserved`;return e.out(a),e.emit?.({type:"error",message:a,code:"BINDING_MISMATCH"}),i?.release(),2}d("binding_migrate",{sid:p.session_id},p.session_id);let l=p.resume&&"schema"in p.resume?{...p.resume,binding:{}}:void 0;try{b=await ce({...p,...l?{resume:l}:{}},{...e,graphSlot:y,...o(e,y),...N?{checkpoint:N}:{}},new Map,n,d,W)}catch(a){throw d("error",{message:a instanceof Error?a.message:String(a),stack:a instanceof Error?a.stack:void 0},p.session_id),K(),a}finally{e.chat?.setWorking?.(null),Q()}}if(b.highRisk)return e.out(`error: ${b.highRisk.length} high-risk decision${b.highRisk.length===1?"":"s"} need a human \u2014 ci mode won't guess. Re-run with --mode agent to pause for review.`),e.emit?.({type:"error",message:`error: high-risk question(s) in ci mode (fail-closed): ${b.highRisk.map(s=>s.id).join(", ")}`,code:"HIGH_RISK_CI"}),K(),q(),1;if(b.paused){let s=i;s||(s=ne(e.contextDir,{sid:p.session_id,mode:"agent",created_at:F.toISOString(),expires_at:new Date(F.getTime()+1440*60*1e3).toISOString(),agent_state:b.paused.agent_state,pending:{questions:[],proposals:[]},read_basis:Object.fromEntries((n.resolve(r)?n.edgesInto(n.resolve(r).tip):[]).filter(a=>a.type==="DERIVES"&&typeof a.props.source_id=="string").map(a=>[String(a.props.source_id),n.heads.get(String(a.props.source_id))??null])),assumed:[],corpus_cursor:{remaining:[]},conv_source:u,target_pins:n.resolve(r)?[{ref:r,cid:n.resolve(r).tip}]:[],verb:"design",use_case:r,...n.resolve(r)?.tip?{uc_tip:n.resolve(r).tip}:{},...S?{force:!0}:{},...v?{user_session_id:v.ids.session_id}:{}}));try{S&&!s.state.force&&s.save({force:!0}),v&&s.state.user_session_id!==v.ids.session_id&&s.save({user_session_id:v.ids.session_id}),u&&s.state.conv_source!==u&&s.save({conv_source:u});let a=e.chat?.drainHeldReceipts?.()??[];(a.length>0||(s.state.held_receipts?.length??0)>0)&&s.save({held_receipts:a}),k!==null&&s.save({force_scope:k}),Me(s,b.paused)}catch(a){let m=s.state.checkpoint,h=`error: couldn't persist the pause for session ${s.state.sid}`+(m?` \u2014 last durable checkpoint: seq ${m.seq} @ ${m.ts}`:" \u2014 no durable checkpoint exists")+` (${a instanceof Error?a.message:String(a)})`;return e.out(h),e.emit?.({type:"error",message:h,code:"PAUSE_PERSIST_FAILED",sid:s.state.sid}),1}d("session_paused",{sid:s.state.sid},p.session_id);let c=R!=="interactive"?` --mode ${R}`:"",l=`kane-cli design tests --resume ${s.state.sid}${c}`;return e.out(`paused \u2014 resume with: ${l}`),e.emit?.({type:"session_paused",sid:s.state.sid,mode:R,resume:l,expires_at:s.state.expires_at,pending_questions:b.paused.pending.questions}),e.chat?.ledger?.({kind:"pause",sid:s.state.sid,expires_at:s.state.expires_at,resume:l,messageForm:`${l} --message "<your words>"`}),q(),3}if(b.crashed&&i?.state.checkpoint){let s=i.state.checkpoint,c=R!=="interactive"?` --mode ${R}`:"",l=`kane-cli design tests --resume ${i.state.sid}${c}`;return d("agent_crashed_resumable",{sid:i.state.sid,seq:s.seq},p.session_id),e.out(`agent crashed \u2014 session ${i.state.sid} is resumable at checkpoint seq ${s.seq} (at most the in-flight turn lost); resume with: ${l}`),e.emit?.({type:"session_paused",sid:i.state.sid,mode:R,resume:l,expires_at:i.state.expires_at,crashed:!0}),i.release(),i=null,3}if(b.error)return e.out(`error: design agent failed: ${b.error}`),e.emit?.({type:"error",message:`error: design agent failed: ${b.error}`}),K(),q(),1;if(b.proposal==null&&R!=="interactive")return e.out(`error: the design session stopped before saving anything \u2014 nothing committed (trace: ${P})`),e.emit?.({type:"error",message:`error: the design session stopped before saving anything \u2014 nothing committed (trace: ${P})`}),K(),q(),1;let X=0;if(b.proposal==null)try{let{readRecords:s}=await import("./records-IOZTZUZV.js"),c=t.resume??p.session_id;X=s(e.contextDir).records.filter(l=>l.sid===c).reduce((l,a)=>l+a.nodes.filter(m=>m.label!=="source").length,0)}catch{}if(b.proposal==null&&e.out(X>0?`done \u2014 ${X} item(s) committed in this session (earlier legs included); nothing new since the resume`:"done \u2014 nothing designed this session (no finalize before the session ended)"),b.assumedDefaults&&e.out(`assumed: ${b.assumedDefaults} default(s) taken while unattended`),i&&e.emit?.({type:"session_complete",sid:t.resume??p.session_id}),v?.event("ASR_SESSION_COMPLETE",{}),i?.complete(),z)try{lt(fe(e.contextDir,"sessions"))}catch{}if(!e.nested){let s=e.chat?.state.ledger.filter(a=>a.kind==="answer"&&a.receipt.form==="assumed").length??0,c=(b.assumedDefaults??0)+s,l=e.chat?.state.credits?.total??b.creditsTotal;e.chat?.ledger?.({kind:"summary",lines:[`designed: ${_.usecase.logical_id??r}${b.proposal==null?X>0?` (${X} item(s) committed across this session)`:" (nothing committed this session)":""}`,...c>0?[`${c} assumed default(s)`]:[],...l!==void 0?[`credits used: ${l.toFixed(1)}`]:[],`trace: ${te(P)}`]})}return t.plan||Ge(e.contextDir),q(),0}export{Rs as a};

package/dist/chunk-QGKPLOUI.js

@@ -1,2 +0,0 @@
-import { createRequire } from 'module'; const require = createRequire(import.meta.url);
-import{d as Y,f as q,h as H}from"./chunk-2KDGIZED.js";import{a as j,b as L,c as z}from"./chunk-YRFMPIU2.js";import{d as B,f as R}from"./chunk-FNH55WSR.js";import{a as N,b as _,c as M}from"./chunk-TYLYFERW.js";import{a as O}from"./chunk-TZXXJWHA.js";import{m as b}from"./chunk-56PAQAX5.js";import{a as K,b as C,c as G}from"./chunk-AW2XUHH4.js";import{g as J}from"./chunk-HEAIJCGZ.js";import{a as F,b as $}from"./chunk-BRIEBB2U.js";import{c as E}from"./chunk-27U4PLPX.js";import{createHash as be}from"crypto";import{readdir as Ce,stat as Te}from"fs/promises";import{basename as f,extname as Ie,join as Ae,relative as ke}from"path";import{createHash as de}from"crypto";import{createReadStream as le}from"fs";import{mkdir as ce,readFile as ue,rename as fe,writeFile as ge}from"fs/promises";import{dirname as me,join as he}from"path";var we=60,ve=5;function V(){return{entries:[]}}function X(){return he(E,"mobile","app-cache.json")}async function T(e){let r=de("sha256");for await(let t of le(e))r.update(t);return r.digest("hex")}function ye(){return{readFile:e=>ue(e,"utf8"),writeFile:async(e,r)=>{await ce(me(e),{recursive:!0});let t=`${e}.tmp`;await ge(t,r),await fe(t,e)},hashFile:T,now:()=>new Date}}function I(e){if(!e)return;let r=/\/(\d{4})\/(\d{2})\/(\d{2})\//.exec(e);if(!r)return;let[,t,a,n]=r,s=new Date(`${t}-${a}-${n}T00:00:00Z`);return Number.isNaN(s.getTime())?void 0:s.toISOString()}function Pe(e,r){if(!e.storedAt)return!0;let t=new Date(e.storedAt).getTime();return Number.isNaN(t)?!0:(r.getTime()-t)/864e5>=we-ve}var u=class{deps;constructor(r={}){this.deps={...ye(),...r}}async read(){try{let r=JSON.parse(await this.deps.readFile(X()));if(!r||typeof r!="object")return V();let t=r;return{entries:Array.isArray(t.entries)?t.entries:[]}}catch{return V()}}async write(r){await this.deps.writeFile(X(),JSON.stringify(r,null,2))}async hashOf(r){return this.deps.hashFile(r)}async lookup(r){return(await this.read()).entries.find(a=>a.sha256===r.sha256&&a.env===r.env&&a.orgId===r.orgId&&a.type===r.type)}async remember(r){let t=await this.read();t.entries=[...t.entries.filter(a=>!(a.sha256===r.sha256&&a.env===r.env&&a.orgId===r.orgId&&a.type===r.type)),r],await this.write(t)}async forget(r){let t=await this.read(),a=t.entries.length;t.entries=t.entries.filter(n=>!(n.sha256===r.sha256&&n.env===r.env&&n.orgId===r.orgId&&n.type===r.type)),t.entries.length!==a&&await this.write(t)}isNearExpiry(r){return Pe(r,this.deps.now())}};var Z={emulator:[".apk"],simulator:[".zip"]};function Q(e){return e.skipped===!0}function De(e,r){let t=Ie(e).toLowerCase();return t===".ipa"?`${f(e)} is a device build \u2014 .ipa is not accepted for ${r} runs.`:Z[r].includes(t)?null:`${f(e)} cannot be uploaded for a ${r} run \u2014 expected one of ${Z[r].join(", ")}.`}async function A(e,r){if(!(await Te(e)).isDirectory())return r.hashOf(e);let a=[],n=async i=>{for(let o of await Ce(i,{withFileTypes:!0})){let p=Ae(i,o.name);o.isDirectory()?await n(p):o.isFile()&&a.push(p)}};await n(e),a.sort();let s=be("sha256");for(let i of a)s.update(ke(e,i)),s.update("\0"),s.update(await T(i)),s.update("\0");return s.digest("hex")}async function W(e){let r=De(e.path,e.type);if(r)return{skipped:!0,reason:r};let t=e.cache??new u,a=e.client??new J(e.baseUrl,e.auth),n;try{n=await A(e.path,t)}catch(o){return{skipped:!0,reason:`could not read ${f(e.path)}: ${o.message}`}}let s={sha256:n,env:e.env,orgId:e.orgId,type:e.type},i=await t.lookup(s);if(i){if(await a.liveness(i.appId)!=="gone")return{appId:i.appId,...i.appUrl?{appUrl:i.appUrl}:{},fromCache:!0};e.onProgress?.(`${i.appId} is no longer in the cloud \u2014 uploading again`),await t.forget(s)}try{e.onProgress?.(`uploading ${f(e.path)}\u2026`);let o=await a.upload(e.path,e.type);return await t.remember({sha256:n,env:e.env,orgId:e.orgId,type:e.type,appId:o.appId,...o.appUrl?{appUrl:o.appUrl}:{},...I(o.url)?{storedAt:I(o.url)}:{},sourcePath:e.path}),e.onProgress?.(o.cached?`${f(e.path)} already in the cloud (${o.appId})`:`${f(e.path)} uploaded (${o.appId})`),{appId:o.appId,...o.appUrl?{appUrl:o.appUrl}:{},fromCache:!1}}catch(o){return{skipped:!0,reason:o.message}}}function h(e){return`${e.platform}|${F(e)}`}var g=new Map,ee=new Set;function re(e){return ee.has(h(e))}function We(e,r,t){r.state==="stopped"&&(g.has(h(r))||ae(e,r,t))}async function te(e,r,t){let a=g.get(h(r));return a?(t?.(`waiting for ${r.displayName} to finish booting\u2026`),a):ae(e,r,t)}function ae(e,r,t){let a=h(r),n=e.prepare(r,t);g.set(a,n),r.state==="stopped"&&n.then(()=>ee.add(a),()=>{});let s=()=>{g.get(a)===n&&g.delete(a)};return n.then(s,s),n.catch(()=>{}),n}import{basename as xe}from"path";import{spawnSync as Ue}from"child_process";async function Se(e,r,t){if(!e.teardownPlan||!t.appPackage&&!t.shutdown)return;let a;try{a=await e.teardownPlan(r,t)}catch{return}a.length!==0&&b(`device:${r.id}`,()=>{Y({udid:r.id,displayName:r.displayName});for(let n of a)try{Ue(n.file,n.args,{timeout:3e4,stdio:"ignore"})}catch{}})}var oe={emulator:[".apk"],simulator:[".zip"]};async function Ee(e,r,t,a){if(e.kind==="package")return e;if(e.kind==="app_id"){let n=r.cloudUpload;if(!n)throw new Error(`${e.value} is an app id, which needs an account to download it. Log in, or pass a path to a local build instead.`);let s=await G({appId:e.value,baseUrl:n.baseUrl,auth:n.auth,...oe[t]?{accepts:oe[t]}:{},...a?{onProgress:a}:{}}),i=D(s.path);if(!i||i.kind==="app_id")throw new Error(`${s.name} is not a build this CLI can install (from ${e.value}).`);return i}try{let n=new u,s=await A(e.value,n),i=new K;await i.find(s)||a?.(`copying ${xe(e.value)} into the local app store\u2026`);let p=await i.put({key:s,sourcePath:e.value,source:"local"});return{...e,value:p.path}}catch{return e}}function Fe(e){b(`appium:${e}`,()=>{H({deviceClass:e,owner:process.pid})})}var k=class extends Error{constructor(r){super(r),this.name="MobileHostUnsupportedError"}},w=class extends Error{constructor(t,a){super(t);this.doctorText=a;this.name="MobilePreflightError"}};async function $e(e,r,t){let a=t.cloudUpload,n=await W({path:e,type:r,env:a.env,orgId:a.orgId,userId:a.userId,auth:a.auth,baseUrl:a.baseUrl,...t.onProgress?{onProgress:t.onProgress}:{}});if(Q(n)){t.onProgress?.(`app not uploaded \u2014 ${n.reason}`);return}return n.appId}var Ne="app must be a build (.apk for an emulator, .zip of the .app bundle for a simulator) or an app id from your cloud uploads \u2014 a package id names something already installed on one device, so it cannot be uploaded, exported as code, or run anywhere else.",ne=/\.(apk|zip)$/i;function D(e){let r=e.trim();if(C(r))return{kind:"app_id",value:r};let t=ne.exec(r)?.[1]?.toLowerCase();return t?{kind:t,value:r}:null}function _e(e){return!!e&&(ne.test(e)||C(e.trim()))}function Me(e){return e.filter(r=>r.required&&r.status==="fail")}function Be(e,r){return!!r&&e.platform===r.platform&&e.kind===r.kind&&(e.id===r.id||e.virtualName===r.id)}async function mr(e){let r=O();if(!r.supported)throw new k(r.reason);let t=e.appiumUrl??e.defaults?.appium_url,a=!!(e.agent||!e.interactive),n=M();a&&e.platform?.toLowerCase()!=="ios"&&((await n.status("emulator")).installed||await n.ensure("emulator",{automatic:!0,onProgress:e.onProgress}));let s=await j(e.platform,{appiumUrl:t});if(z(s)){let d=s.sections.flatMap(P=>Me(P.checks)).map(P=>P.label).join(", ");throw new w(`Mobile toolchain not ready (${d}). Run \`kane-cli doctor\` for details.`,L(s))}let i=await R({device:e.device,platform:e.platform,defaultTarget:e.defaults?.default_target,interactive:e.interactive}),o;if(i.ok)o=i.target;else if(i.reason==="needs-picker"&&e.pickTarget){let d=await e.pickTarget(i.candidates);if(!d)throw new Error("Target selection cancelled");o=d}else throw new Error(i.message);let p=B(o.platform);if(!p)throw new Error(`No provider for platform "${o.platform}"`);let l=N(o);if(!l)throw new Error(`No managed dependencies serve ${o.platform} ${o.kind} targets yet.`);try{await n.ensure(l,{automatic:a,onProgress:e.onProgress})}catch(d){throw d instanceof _?new w(d.message,d.message):d}let ie=o.state!=="ready"||re(o);o=await te(p,o,e.onProgress);let se=await q(l,{...t?{appiumUrl:t}:{},device:{udid:o.id,displayName:o.displayName},onProgress:e.onProgress});Fe(l);let x=Be(o,e.defaults?.default_target)?e.defaults?.default_app:void 0,m=e.app??(_e(x)?x:void 0);if(e.app&&!D(e.app))throw new Error(`${e.app}: ${Ne}`);let c=m?D(m):null,U=c?await Ee(c,e,l,e.onProgress):null,v=U?await p.ensureApp(o,U,e.onProgress):void 0,y=c?.kind==="app_id"?c.value:e.cloudUpload&&c&&m?await $e(c.value,l,e):void 0;await Se(p,o,{shutdown:ie,...v?{appPackage:v}:{}});let pe=$(o,v,{noReset:e.noReset??e.defaults?.no_reset,appiumUrl:se.url}),S=y??m;return{device:pe,target:o,provider:p,...y?{appId:y}:{},...S?{appRef:S}:{}}}export{We as a,te as b,k as c,w as d,Ne as e,D as f,_e as g,mr as h};

package/dist/chunk-RLRNLIRS.js

@@ -1,2 +0,0 @@
-import { createRequire } from 'module'; const require = createRequire(import.meta.url);
-import{a as v,b as w,d as C}from"./chunk-OS4VSIHT.js";import{b as k}from"./chunk-TRJUD3XJ.js";import{a as T}from"./chunk-JFAFKHDX.js";import{a as E}from"./chunk-JZ26R6UL.js";import{A as y,B as O}from"./chunk-TH47OOBV.js";import{d,e as g}from"./chunk-WXHQYYD5.js";var D=new Set([d.USECASE,d.SCENARIO,d.AC,d.TEST]);function p(e,t){return!e.superseded.has(t)&&e.trust.get(t)!=="archived"}function b(e,t,n){let o=e.edgesFrom(t).find(s=>s.type===n);return o?e.tipOf(o.dst):null}function S(e,t,n){if(n===d.USECASE)return t;if(n===d.SCENARIO)return b(e,t,g.BELONGS_TO);if(n===d.AC){let o=b(e,t,g.SCOPED_TO);return o?e.nodeLabel.get(o)===d.USECASE?o:b(e,o,g.BELONGS_TO):null}if(n===d.TEST){let o=b(e,t,g.AUTOMATES);return o?b(e,o,g.BELONGS_TO):null}return null}function A(e,t){let n=e.nameOf.get(t);if(n)return n;for(let[o,s]of e.names)if(e.tipOf(s)===t)return o;return t}function G(e,t){return{ucTip:t,display:A(e,t),seamRef:e.nameOf.get(t)??t}}function L(e,t){let n=e.resolve(t);if(!n)return{ok:!1,message:`unknown ref '${t}' \u2014 no test/scenario/ac/use-case by that id or cid`};let o=n.tip,s=e.nodeLabel.get(o);if(!s||!D.has(s))return{ok:!1,message:`'${t}' is a ${s??"missing node"} \u2014 evolve takes a test, scenario, acceptance criterion, or use-case`};let a=S(e,o,s);return!a||e.nodeLabel.get(a)!==d.USECASE?{ok:!1,message:`cannot resolve '${t}' to a parent use-case \u2014 its ${s} chain is broken`}:e.superseded.has(a)?{ok:!1,message:`use-case ${A(e,a)} was removed \u2014 nothing to evolve`}:{ok:!0,target:G(e,a)}}function z(e,t){return h(e,t)}function h(e,t){let n=[];for(let{cid:s}of e.byLabel(d.SCENARIO)){if(!p(e,s)||!e.edgesFrom(s).some(r=>r.type===g.BELONGS_TO&&e.tipOf(r.dst)===t))continue;let a=e.edgesInto(s).filter(r=>r.type===g.AUTOMATES&&p(e,r.src));if(a.length===0)n.push({scenario:s,test:null});else for(let r of a)n.push({scenario:s,test:r.src})}let o=new Map;for(let{cid:s}of e.byLabel(d.AC)){if(!p(e,s)||S(e,s,d.AC)!==t)continue;let a=e.edgesInto(s).filter(r=>r.type===g.VERIFIES&&p(e,r.src)).map(r=>r.src).sort();o.set(s,a)}return{pairs:n,verifies:o}}function x(e,t){let n=r=>`${r.scenario}\0${r.test??""}`,o=new Set(e.pairs.map(n)),s=new Set(t.pairs.map(n)),a=[];for(let[r,i]of e.verifies){let u=t.verifies.get(r);u&&(i.length===u.length&&i.every((l,f)=>l===u[f])||a.push({ac:r,before:i,after:u}))}return{superseded:e.pairs.filter(r=>!s.has(n(r))),minted:t.pairs.filter(r=>!o.has(n(r))),retained:t.pairs.filter(r=>o.has(n(r))),moves:a}}function P(e,t,n,o,s){let a=i=>t.nameOf.get(i)??i,r=i=>`  - ${a(i.scenario)} \xB7 ${i.test?a(i.test):"(no test)"}`;e.out(`evolved: use-case ${n} \u2014 design record ${o.before} \u2192 ${o.after}`),e.out(`superseded: ${s.superseded.length} pair(s)`);for(let i of s.superseded)e.out(r(i));e.out(`minted: ${s.minted.length} pair(s)`);for(let i of s.minted)e.out(r(i));e.out(`retained: ${s.retained.length} pair(s)`);for(let i of s.retained)e.out(r(i));if(s.moves.length===0)e.out("verifies moves: none");else{e.out("verifies moves:");for(let i of s.moves){let u=l=>l.length>0?l.map(a).join(" + "):"(none)";e.out(`  - ${a(i.ac)}: ${u(i.before)} \u2192 ${u(i.after)}`)}}}async function U(e,t,n,o,s,a){let r=y(e),i=E(r,t.ucTip);if(!i)return a==="batch"?(o.out(`note: ${t.display} has no design output \u2014 nothing to evolve; run kane-cli design tests --use-case ${t.display} first`),{code:0,outcome:"no-design"}):(v(o,`nothing to evolve \u2014 run kane-cli design tests --use-case ${t.display} first (no design output)`),{code:2,outcome:"no-design"});let u=h(r,t.ucTip),l=`evolve re-designs the parent use-case ${t.display}; ${u.pairs.length} pair(s) affected`;if(n.yes)o.out(l);else if(!await o.confirm(`${l} \u2014 proceed?`))return o.out(a==="batch"?`skipped ${t.display}`:"declined \u2014 nothing evolved"),{code:0,outcome:"declined"};let f=k(e,r,t.ucTip,n.because),c=await s(t.seamRef,{yes:!!n.yes,...n.mode?{mode:n.mode}:{},...n.because?{because:n.because}:{},...f!==void 0?{changeDelta:f.change_delta,priorDesign:f.prior_design}:{}});if(c===3)return o.out(`design session for ${t.display} paused \u2014 resume with \`kane-cli design tests --resume\`, then re-run evolve for the diff`),{code:c,outcome:"paused"};if(c!==0)return v(o,`design run for ${t.display} ended with exit code ${c} \u2014 no diff to report`),{code:c,outcome:"failed"};let m=y(e),$=m.tipOf(t.ucTip),R=E(m,$)?.seq;return P(o,m,t.display,{before:i.seq,after:R??"?"},x(u,h(m,$))),{code:0,outcome:"evolved"}}function F(e){let t=new Map,n=0;for(let{cid:s,state:a}of e.staleList()){if(a==="superseded")continue;let r=e.nodeLabel.get(s);if(!r||!D.has(r)||!p(e,s)||!O(e,s))continue;let i=S(e,s,r);!i||e.nodeLabel.get(i)!==d.USECASE||e.superseded.has(i)||(n++,t.has(i)||t.set(i,G(e,i)))}return{targets:[...t.values()].sort((s,a)=>s.display<a.display?-1:s.display>a.display?1:0),staleCount:n}}function I(e,t){for(let{cid:n,state:o}of e.staleList()){if(o==="superseded")continue;let s=e.nodeLabel.get(n);if(!(!s||!D.has(s)||!p(e,n))&&O(e,n)&&S(e,n,s)===t)return!0}return!1}async function N(e,t,n,o={},s=process.cwd()){if(e&&t.fromStale)return v(n,"pass a <ref> OR --from-stale, not both"),2;if(!e&&!t.fromStale)return v(n,"evolve needs a <ref> or --from-stale"),2;let a=w(s,n);if(!a)return 2;let r=o.runDesignForUc??_;n.out(`evolving ${e??"stale use-cases"}: reading the graph\u2026`);let i=y(a),u,l=null;if(e){let c=L(i,e);if(!c.ok)return v(n,c.message),2;if(!t.because&&E(i,c.target.ucTip)&&!I(i,c.target.ucTip))return v(n,`nothing changed underneath ${e} \u2014 its sources and requirements are current; use --because "<reason>" to re-design anyway`),2;u=[c.target]}else{let{targets:c,staleCount:m}=F(i);if(c.length===0)return n.out("nothing stale \u2014 nothing to evolve"),0;l=`from-stale: ${m} stale node(s) \u2192 ${c.length} use-case(s)`,u=c}if(!t.yes&&!n.isTTY)return v(n,"evolve needs a TTY \u2014 the blast-radius confirm is the point; headless evolution rides `kane-cli maintain reconcile`"),2;if(l&&n.out(l),e){let c=await U(a,u[0],t,n,r,"single");return c.outcome==="evolved"&&t.because&&T(a,{ts:new Date().toISOString(),command:"evolve",id:e,verdict:"gap-resolved-evolve",polarity:"preference",by:{kind:"human",id:process.env.USER??"operator"},target:e,reason:t.because}),c.code}let f=0;for(let c of u){let{code:m}=await U(a,c,t,n,r,"batch");m!==0&&f===0&&(f=m)}return f}var _=async(e,t)=>{let{designTestsCommand:n}=await import("./bind-STKXOUYI.js"),o=()=>n({useCase:e,force:!0,...t.mode?{mode:t.mode}:t.yes?{mode:"override"}:{},...t.because?{because:t.because}:{},...t.changeDelta!==void 0?{changeDelta:t.changeDelta}:{},...t.priorDesign!==void 0?{priorDesign:t.priorDesign}:{}});if(t.mode!=="agent")return o();let s=process.stdout.write;process.stdout.write=((...a)=>!0);try{return await o()}finally{process.stdout.write=s}};async function J(e,t){return N(e,t,C(),{})}export{L as a,z as b,U as c,F as d,N as e,_ as f,J as g};

package/dist/chunk-TYLYFERW.js

@@ -1,10 +0,0 @@
-import { createRequire } from 'module'; const require = createRequire(import.meta.url);
-import{d as W}from"./chunk-MSGW4JDG.js";import{d as q,e as F}from"./chunk-4JOD47QI.js";import{a as L}from"./chunk-27U4PLPX.js";import{createHash as Y}from"crypto";import{access as Q,mkdir as T,mkdtemp as Z,readdir as O,readFile as v,rename as N,rm as y,writeFile as E}from"fs/promises";import{homedir as tt}from"os";import{arch as et,platform as st}from"process";import{dirname as j,isAbsolute as nt,join as l,relative as X,resolve as rt,sep as it}from"path";var z=1,ot={emulator:"emulator",simulator:"simulator"};function Et(i){return ot[i.kind]??null}var H=class extends Error{constructor(s,e,n){super([`Managed mobile dependencies for ${s} are not installed.`,`- kaneai-mobile-deps ${s} ${e.bundleVersion}: ${e.url} (${_(e.bytes)})`,`Destination: ${n}`,"Run `kane-cli doctor --install` to download it."].join(`
-`));this.deviceClass=s;this.name="DepsInstallRequiredError"}};function _(i){return i>=1024*1024?`${Math.ceil(i/(1024*1024))} MB`:`${i} bytes`}function at(i){let t=i/1048576;return t>=10?`${Math.round(t)} MB/s`:t>=1?`${t.toFixed(1)} MB/s`:`${Math.max(1,Math.round(i/1024))} KB/s`}function lt(i){let t=Math.max(1,Math.round(i));return t<60?`~${t}s left`:`~${Math.floor(t/60)}m ${t%60}s left`}var C=8*1024*1024,ct=8;function ut(i){if(!Number.isFinite(i)||i<2*C)return null;let t=Math.min(ct,Math.floor(i/C)),s=Math.ceil(i/t),e=[];for(let n=0;n<i;n+=s)e.push({start:n,end:Math.min(n+s,i)-1});return e}async function U(i,t){let s=i.body;if(!s||typeof s.getReader!="function"){let c=new Uint8Array(await i.arrayBuffer());return t?.(c.length),c}let e=s.getReader(),n=[],r=0;for(;;){let{done:c,value:f}=await e.read();if(c)break;f&&(n.push(f),r+=f.length,t?.(f.length))}let o=new Uint8Array(r),a=0;for(let c of n)o.set(c,a),a+=c.length;return o}var K=3,dt=3e4,k=class extends Error{};async function pt(i,t,s,e,n,r=dt){let o=new Uint8Array(s),a=0,c=new AbortController,f=null,b=!1;try{await Promise.all(e.map(async(h,A)=>{let M=0,S=d=>{M+=d,a+=d,n?.(a)},V=()=>{a=Math.max(0,a-M),M=0},R=null;for(let d=0;d<K;d+=1){if(c.signal.aborted)return;let u=new AbortController,m=()=>u.abort();c.signal.addEventListener("abort",m,{once:!0});let w=!1,g=null,$=()=>{g&&clearTimeout(g),g=setTimeout(()=>{w=!0,u.abort()},r)};try{$();let p=await i(t,{headers:{Range:`bytes=${h.start}-${h.end}`},signal:u.signal});if(typeof p.body?.getReader!="function"&&g&&(clearTimeout(g),g=null),!p.ok)throw new k(`Could not download ${t}: HTTP ${p.status}`);if(p.status!==206){b=!0,A===0?f=await U(p,I=>{$(),S(I)}):await(p.body?.cancel().catch(()=>{})??Promise.resolve());return}let D=h.end-h.start+1,P=await U(p,I=>{$(),S(I)});if(P.length!==D)throw new Error(`range ${h.start}-${h.end} returned ${P.length} bytes (expected ${D})`);o.set(P,h.start);return}catch(p){if(p instanceof k)throw p;if(c.signal.aborted)return;V(),R=w?new Error(`no data for ${Math.round(r/1e3)}s`):p instanceof Error?p:new Error(String(p))}finally{g&&clearTimeout(g),c.signal.removeEventListener("abort",m)}}throw new Error(`Could not download ${t}: range ${h.start}-${h.end} failed after ${K} attempts (${R?.message??"unknown error"}) \u2014 check your network and rerun \`kane-cli doctor --install\`.`)}))}catch(h){throw c.abort(),h}return f||(b?null:o)}async function ft(i,t,s,e,n){let r=ut(s);if(r){let c=await pt(i,t,s,r,e,n?.stallMs);if(c)return c}let o=await i(t);if(!o.ok)throw new Error(`Could not download ${t}: HTTP ${o.status}`);let a=0;return U(o,e&&(c=>{a+=c,e(a)}))}function ht(i){return Y("sha256").update(i).digest("hex")}function mt(i,t){let s=X(i,t);return s!==""&&!s.startsWith(`..${it}`)&&s!==".."&&!nt(s)}async function x(i){try{return await Q(i),!0}catch{return!1}}function wt(){return{home:tt(),os:st,arch:et,cliVersion:L,nodeModuleVersion:process.versions.modules,fetch,resolveBundle:async i=>(await import("./deps-resolve-XC5S53DG.js")).controllerResolveBundle()(i),exec:q,now:()=>new Date,wait:F,processAlive:i=>{try{return process.kill(i,0),!0}catch{return!1}}}}var B=class extends Error{constructor(s,e,n){super(`No managed mobile dependencies are published for ${s} (kane-cli ${e}).
-This is a packaging gap, not something to install locally \u2014 report it, or pass --appium-url to use an Appium server you manage yourself.`);this.coordinate=s;this.cause=n;this.name="NoPublishedBundleError"}},J=class{deps;constructor(t={}){this.deps={...wt(),...t}}mobileRoot(){return l(this.deps.home,".testmuai","kaneai","mobile")}depsRoot(){return l(this.mobileRoot(),"deps")}classRoot(t,s){return l(this.depsRoot(),s,t)}paths(t,s){let e=this.classRoot(t,s);return{root:e,appium:l(e,"appium"),appiumHome:l(e,"appium-home"),platformTools:l(e,"platform-tools"),wdaDir:l(e,"wda","Build","Products","Debug-iphonesimulator"),iwdpBinDir:l(e,"bin"),installManifest:l(e,"install-manifest.json")}}async status(t,s){let e=[];try{e=await O(this.depsRoot())}catch{}s&&(e=e.filter(c=>c===s));let n=null;for(let c of e){let f=this.classRoot(t,c),b=null;try{b=JSON.parse(await v(l(f,"install-manifest.json"),"utf8"))}catch{continue}b.schemaVersion===z&&(!s&&b.cliVersion!==this.deps.cliVersion||(!n||b.installedAt>n.manifest.installedAt)&&(n={manifest:b,root:f}))}if(!n)return{class:t,installed:!1};let r=this.paths(t,n.manifest.bundleVersion),o=[l(r.appium,"node_modules","appium","index.js")];t==="emulator"&&o.push(l(r.platformTools,this.deps.os==="win32"?"adb.exe":"adb")),t==="simulator"&&o.push(l(r.wdaDir,"WebDriverAgentRunner-Runner.app"));for(let c of o)if(!await x(c))return{class:t,installed:!1,version:n.manifest.bundleVersion,root:n.root,corrupt:`a bundle component is missing from disk (${X(n.root,c)})`};let a=await this.postInstallDrifted(r);return{class:t,installed:!0,version:n.manifest.bundleVersion,root:n.root,...a?{needsRepair:a}:{}}}async postInstallDrifted(t){let s=l(t.appiumHome,"node_modules",".cache","appium","extensions.yaml");if(!await x(s))return!1;let e=await v(s,"utf8");for(let n of e.split(`
-`)){let r=/^\s*installPath:\s*(.+?)\s*$/.exec(n);if(r&&!r[1].startsWith(t.appiumHome))return!0}return!1}async environment(t){let s=await this.status(t);if(!s.installed||!s.version)return{dirs:[]};let e=this.paths(t,s.version),n=[],r={dirs:n,appiumHome:e.appiumHome};return t!=="simulator"&&(n.push(e.platformTools),r.platformToolsDir=e.platformTools),n.push(l(e.appium,"node_modules",".bin")),t==="simulator"&&(n.push(e.iwdpBinDir),r.wdaDir=e.wdaDir,r.wdaRoot=l(e.root,"wda"),r.iwdpBinDir=e.iwdpBinDir),r}async ensure(t,s){let e,n;try{e=await this.resolveOrExplain(t)}catch(a){n=a}let r=await this.status(t,e?.bundleVersion);if(r.installed&&!r.needsRepair)return e&&r.version&&await this.adoptInstall(t,r.version),r;if(!e)throw n;if(r.installed&&r.needsRepair&&r.version){let a=this.paths(t,r.version);return await this.withInstallLock(async()=>{await this.postInstall(a.root,a,s.onProgress)}),await this.adoptInstall(t,r.version),this.status(t,e.bundleVersion)}let o=e;if(!s.automatic&&!s.approved)throw new H(t,o,this.classRoot(t,o.bundleVersion));return await this.withInstallLock(async()=>{(await this.status(t,o.bundleVersion)).installed||await this.install(t,o,s.onProgress)}),this.status(t,o.bundleVersion)}async adoptInstall(t,s){try{let e=this.paths(t,s).installManifest,n=JSON.parse(await v(e,"utf8"));if(n.cliVersion===this.deps.cliVersion)return;n.cliVersion=this.deps.cliVersion;let r=l(j(e),`install-manifest-${process.pid}.json`);await E(r,`${JSON.stringify(n,null,2)}
-`),await N(r,e)}catch{}}async resolveOrExplain(t){let s=`${this.deps.os}-${this.deps.arch}-${t}`,e;try{e=await this.deps.resolveBundle({cliVersion:this.deps.cliVersion,os:this.deps.os,arch:this.deps.arch,deviceClass:t})}catch(n){throw new B(s,this.deps.cliVersion,n)}if(!e?.url||!e.sha256||!e.bundleVersion)throw new B(s,this.deps.cliVersion);return e}async install(t,s,e){let n=this.paths(t,s.bundleVersion),r=l(this.depsRoot(),s.bundleVersion);await T(r,{recursive:!0});let o=await Z(l(r,".staging-"));try{e?.(`Downloading the ${t} dependencies ${s.bundleVersion} (${_(s.bytes)}) \u2014 this happens once\u2026`);let a=[],c=-1,f=0,b=await this.download(s,(d,u)=>{if(!u)return;let m=Math.min(d,u),w=this.deps.now().getTime();for(a.push({t:w,received:m});a.length>1&&a[0].t<w-3e3;)a.shift();let g=Math.min(100,Math.floor(m/u*20)*5);if(g===c&&w-f<2e3&&m<u)return;c=g,f=w;let $=a[0],p=(w-$.t)/1e3,D=p>0?(m-$.received)/p:0,P=D>0&&m<u?` \xB7 ${at(D)} \xB7 ${lt((u-m)/D)}`:"";e?.(`Downloading the ${t} dependencies \u2014 ${_(m)} / ${_(u)} (${g}%)${P}`)}),h=W(b),A=gt(h);for(let[d,u]of Object.entries(h)){if(d.endsWith("/"))continue;let m=A&&d.startsWith(A)?d.slice(A.length):d;if(!m)continue;let w=rt(o,m);if(!mt(o,w))throw new Error(`Unsafe path in ${s.url}: ${d}`);await T(j(w),{recursive:!0}),await E(w,u,this.deps.os!=="win32"?{mode:493}:{})}let M=await this.readBundleManifest(o,s.url,t);await this.postInstall(o,n,e),await y(n.root,{recursive:!0,force:!0}),await N(o,n.root);let S={schemaVersion:z,class:t,bundleVersion:s.bundleVersion,cliVersion:this.deps.cliVersion,os:this.deps.os,arch:this.deps.arch,sha256:s.sha256,bytes:s.bytes,sourceUrl:s.url,installedAt:this.deps.now().toISOString(),nodeAbi:M.node_abi?.node_module_version??this.deps.nodeModuleVersion,postInstall:{quarantineStripped:this.deps.os==="darwin",extensionsRewritten:!0}},V=l(r,`install-manifest-${process.pid}.json`);await E(V,`${JSON.stringify(S,null,2)}
-`),await N(V,n.installManifest),await this.gcOldVersions(t);let R=l(this.mobileRoot(),"trees");await x(R)&&(await this.reapLegacyServers(R,e),await y(R,{recursive:!0,force:!0}),e?.("Removed the legacy per-component toolchain trees"));for(let d of["emulator","simulator"]){let u=l(this.depsRoot(),d);await x(l(u,"install-manifest.json"))||await x(u)&&(await y(u,{recursive:!0,force:!0}),e?.(`Removed the previous ${d} deps layout`))}}finally{await y(o,{recursive:!0,force:!0})}}async reapLegacyServers(t,s){if(this.deps.os==="win32")return;let e=await this.deps.exec("pgrep",["-f",t],{timeoutMs:1e4});if(e.code!==0)return;let n=e.stdout.split(`
-`).map(r=>r.trim()).filter(r=>/^\d+$/.test(r));for(let r of n)await this.deps.exec("kill",[r],{timeoutMs:5e3});n.length>0&&s?.(`Stopped ${n.length} legacy managed server process${n.length===1?"":"es"} before removing the old toolchain trees`)}async gcOldVersions(t){let s=[];try{s=await O(this.depsRoot())}catch{return}let e=[];for(let n of s){let r=this.classRoot(t,n);try{let o=JSON.parse(await v(l(r,"install-manifest.json"),"utf8"));e.push({root:r,installedAt:o.installedAt})}catch{}}e.sort((n,r)=>n.installedAt<r.installedAt?1:-1);for(let n of e.slice(2)){await y(n.root,{recursive:!0,force:!0});let r=j(n.root);try{(await O(r)).length===0&&await y(r,{recursive:!0,force:!0})}catch{}}}async download(t,s){let e=null;for(let n=0;n<2;n+=1){let r=await ft(this.deps.fetch,t.url,t.bytes,s&&(a=>s(a,t.bytes))),o=ht(r);if(o===t.sha256)return r;e=new Error(`Checksum mismatch for ${t.url}: expected ${t.sha256}, got ${o}.`)}throw e??new Error(`Could not download ${t.url}`)}async readBundleManifest(t,s,e){let n;try{n=JSON.parse(await v(l(t,"manifest.json"),"utf8"))}catch{throw new Error(`The bundle at ${s} carries no readable manifest.json; refusing to install it.`)}if(n.platform!==this.deps.os||n.arch!==this.deps.arch)throw new Error(`The bundle at ${s} is built for ${n.platform}-${n.arch}; this host is ${this.deps.os}-${this.deps.arch}. A wrong blob was published for this coordinate.`);if(!n.supported_targets?.includes(e))throw new Error(`The bundle at ${s} does not support the ${e} device class (it supports: ${n.supported_targets?.join(", ")||"nothing"}). A wrong blob was published.`);return n}async postInstall(t,s,e){this.deps.os==="darwin"&&await this.deps.exec("xattr",["-dr","com.apple.quarantine",t],{timeoutMs:6e4});let n=l(t,"appium-home","node_modules",".cache","appium","extensions.yaml");if(await x(n)){let r=await v(n,"utf8"),o=bt(r,s.appiumHome);await E(n,o),e?.("Rewrote Appium extension paths for this machine")}}async withInstallLock(t){let s=l(this.mobileRoot(),"install.lock"),e=Date.now();for(await T(this.mobileRoot(),{recursive:!0});;)try{await T(s),await E(l(s,"owner.json"),JSON.stringify({pid:process.pid,startedAt:new Date().toISOString()}));try{return await t()}finally{await y(s,{recursive:!0,force:!0})}}catch(n){if(n.code!=="EEXIST")throw n;let r={};try{r=JSON.parse(await v(l(s,"owner.json"),"utf8"))}catch{}if(r.pid&&!this.deps.processAlive(r.pid)){await y(s,{recursive:!0,force:!0});continue}if(Date.now()-e>12e4)throw new Error(`Timed out waiting for the mobile install lock (holder pid ${r.pid??"unknown"}).`);await this.deps.wait(500)}}};function gt(i){let t=Object.keys(i).filter(e=>!e.endsWith("/")),s=new Set(t.map(e=>e.split("/")[0]));return s.size===1&&t.every(e=>e.includes("/"))?`${[...s][0]}/`:""}function bt(i,t){return i.split(`
-`).map(s=>{let e=/^(\s*installPath:\s*)(.+?)\s*$/.exec(s);if(!e)return s;let n=e[2],r=/[\\/]node_modules[\\/]/g,o=-1;for(let a=r.exec(n);a;a=r.exec(n))o=a.index+a[0].length;return o<0?s:`${e[1]}${l(t,"node_modules",n.slice(o))}`}).join(`
-`)}var G;function St(){return G??=new J,G}import{join as yt}from"path";function _t(i=process.env){let t=i.KANE_ANDROID_HOME?.trim();return t?{root:t,platformToolsDir:yt(t,"platform-tools")}:null}export{Et as a,H as b,St as c,_t as d};