@vpxa/aikit 0.1.58 → 0.1.60

package/packages/flows/dist/adapters/native.d.ts

@@ -1,10 +0,0 @@
-import { FlowFormatAdapter, FlowManifest } from "../types.js";
-
-//#region packages/flows/src/adapters/native.d.ts
-declare class NativeAdapter implements FlowFormatAdapter {
-  readonly format: "native";
-  detect(sourceDir: string): boolean;
-  parse(sourceDir: string): Promise<FlowManifest>;
-}
-//#endregion
-export { NativeAdapter };

package/packages/flows/dist/adapters/native.js

@@ -1 +0,0 @@
-import{existsSync as e,readFileSync as t}from"node:fs";import{join as n}from"node:path";var r=class{format=`native`;detect(t){return e(n(t,`flow.json`))}async parse(e){let r=t(n(e,`flow.json`),`utf-8`);return JSON.parse(r)}};export{r as NativeAdapter};

package/packages/flows/dist/adapters/openspec.d.ts

@@ -1,40 +0,0 @@
-import { FlowFormatAdapter, FlowManifest, FlowParseOptions } from "../types.js";
-
-//#region packages/flows/src/adapters/openspec.d.ts
-/**
- * OpenSpec adapter — detects repos that follow the OpenSpec workflow
- * (https://github.com/Fission-AI/OpenSpec) and converts them to FlowManifest.
- *
- * Detection marker: `openspec/config.yaml` in the source directory.
- *
- * Flow steps are derived from the active OpenSpec schema.yaml.
- */
-declare class OpenSpecAdapter implements FlowFormatAdapter {
-  readonly format: "openspec";
-  detect(sourceDir: string): boolean;
-  parse(sourceDir: string, options?: FlowParseOptions): Promise<FlowManifest>;
-  /**
-   * Read metadata from package.json if available, otherwise use defaults
-   * derived from the openspec config.
-   */
-  private readMeta;
-  private readConfigSchema;
-  private resolveSchemaDir;
-  private parseSchemaArtifacts;
-  private loadSchema;
-  private discoverSchemaFromDirectory;
-  private collectMarkdownFiles;
-  private hasFileRecursive;
-  private findSchemaYaml;
-  private toStepIdFromMarkdown;
-  private buildStepsFromSchema;
-  private materializeSteps;
-  private resolveInstructionContent;
-  private normalizeArtifact;
-  private normalizeApply;
-  private readString;
-  private readStringArray;
-  private humanizeStepName;
-}
-//#endregion
-export { OpenSpecAdapter };

package/packages/flows/dist/adapters/openspec.js

@@ -1 +0,0 @@
-import{existsSync as e,mkdirSync as t,readFileSync as n,readdirSync as r,writeFileSync as i}from"node:fs";import{basename as a,join as o,relative as s}from"node:path";import{execSync as c}from"node:child_process";import{parse as l}from"yaml";var u=class{format=`openspec`;detect(t){return!!(e(o(t,`openspec`,`config.yaml`))||e(o(t,`schemas`))&&this.findSchemaYaml(t))}async parse(e,t){let n=this.readMeta(e),r=this.loadSchema(e),i=this.buildStepsFromSchema(r);return await this.materializeSteps(e,i,r,t),{name:n.name,version:n.version,description:r.description??n.description,author:n.author,steps:i,agents:[],artifacts_dir:`openspec`,install:[]}}readMeta(t){let r=o(t,`package.json`);if(e(r))try{let e=JSON.parse(n(r,`utf-8`));return{name:e.name??a(t),version:e.version??`0.1.0`,description:e.description??`OpenSpec flow`,author:e.author}}catch{}return{name:a(t),version:`0.1.0`,description:`OpenSpec flow`}}readConfigSchema(t){let r=o(t,`openspec`,`config.yaml`);if(!e(r))return`spec-driven`;try{let e=l(n(r,`utf-8`));return typeof e?.schema==`string`&&e.schema.trim().length>0?e.schema:`spec-driven`}catch{return`spec-driven`}}resolveSchemaDir(t){let n=this.readConfigSchema(t),r=o(t,`openspec`,`schemas`,n);if(e(o(r,`schema.yaml`)))return r;let i=o(t,`schemas`,n);if(e(o(i,`schema.yaml`)))return i;try{let t=o(c(`npm root -g`,{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).trim(),`@fission-ai`,`openspec`,`schemas`,n);if(e(o(t,`schema.yaml`)))return t}catch{}return null}parseSchemaArtifacts(e){try{let t=l(e);if(!t||!Array.isArray(t.artifacts))return null;let n=t.artifacts.map(e=>this.normalizeArtifact(e)).filter(e=>e!==null);return n.length===0?null:{name:typeof t.name==`string`&&t.name.trim().length>0?t.name:this.readString(t.schema)??`spec-driven`,version:typeof t.version==`number`?t.version:1,description:this.readString(t.description),artifacts:n,apply:this.normalizeApply(t.apply)}}catch{return null}}loadSchema(e){let t=this.resolveSchemaDir(e);if(t){let e=o(t,`schema.yaml`);try{let t=n(e,`utf-8`),r=this.parseSchemaArtifacts(t);if(r)return r}catch{}}return this.discoverSchemaFromDirectory(e)}discoverSchemaFromDirectory(t){let i=[o(t,`openspec`,`schemas`),o(t,`schemas`)];for(let t of i)if(e(t))try{let i=r(t,{withFileTypes:!0}).filter(e=>e.isDirectory());for(let r of i){let i=o(t,r.name,`schema.yaml`);if(e(i))try{let e=this.parseSchemaArtifacts(n(i,`utf-8`));if(e)return e}catch{}}}catch{}let c=[],l=o(t,`openspec`),u=[],d=this.collectMarkdownFiles(l);for(let e of d){let t=s(l,e).replace(/\\/g,`/`),n=this.toStepIdFromMarkdown(t);!n||u.includes(n)||(c.push({id:n,generates:t,description:`${this.humanizeStepName(n)} phase`,template:a(e),requires:u.length>0?[u[u.length-1]]:[]}),u.push(n))}return{name:this.readConfigSchema(t),version:1,artifacts:c}}collectMarkdownFiles(t){if(!e(t))return[];let n=[];try{let e=r(t,{withFileTypes:!0}).sort((e,t)=>e.name.localeCompare(t.name));for(let r of e){let e=o(t,r.name);if(r.isFile()&&r.name.toLowerCase().endsWith(`.md`)){n.push(e);continue}r.isDirectory()&&n.push(...this.collectMarkdownFiles(e))}}catch{}return n}hasFileRecursive(t,n){if(!e(t))return!1;try{let e=r(t,{withFileTypes:!0});for(let r of e)if(r.isFile()&&r.name===n||r.isDirectory()&&this.hasFileRecursive(o(t,r.name),n))return!0}catch{}return!1}findSchemaYaml(t){let n=o(t,`schemas`);if(!e(n))return!1;try{return r(n,{withFileTypes:!0}).filter(e=>e.isDirectory()).some(t=>e(o(n,t.name,`schema.yaml`)))}catch{return!1}}toStepIdFromMarkdown(e){let t=e.replace(/\\/g,`/`).split(`/`).filter(Boolean);if(t.length===0)return null;let n=(t[t.length-1]??``).replace(/\.md$/i,``);return(n.toLowerCase()===`readme`&&t.length>1?t[t.length-2]:n).toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-+|-+$/g,``)||null}buildStepsFromSchema(e){let t=e.artifacts.map(e=>({id:e.id,name:this.humanizeStepName(e.id),instruction:`steps/${e.id}/README.md`,produces:e.generates?[e.generates]:[],requires:e.requires,agents:[],description:e.description}));return e.apply&&t.push({id:`apply`,name:`Apply`,instruction:`steps/apply/README.md`,produces:[],requires:e.apply.requires,agents:[],description:`Implement the tasks, writing code and tests according to the design`}),t}async materializeSteps(n,r,a,s){let c=this.resolveSchemaDir(n),l=new Map(a.artifacts.map(e=>[e.id,e]));for(let u of r){let r=o(n,`steps`,u.id),d=o(r,`README.md`);t(r,{recursive:!0});let f=this.resolveInstructionContent(c,u.id,l.get(u.id),a.apply);if(!f){e(d)||i(d,`# ${u.name}\n\n${u.description}\n`,`utf-8`);continue}i(d,s?.transform?await s.transform({content:f,sourceFormat:`openspec`,stepName:u.id,metadata:{schemaName:a.name,displayName:u.name,description:u.description,produces:u.produces,requires:u.requires}}):`# ${u.name}\n\n${f}`,`utf-8`)}}resolveInstructionContent(t,r,i,a){if(r===`apply`&&a?.instruction)return a.instruction;if(!i)return null;if(i.instruction)return i.instruction;if(t&&i.template){let r=o(t,`templates`,i.template);if(e(r))try{return n(r,`utf-8`)}catch{}}return i.description||null}normalizeArtifact(e){if(!e||typeof e!=`object`)return null;let t=e,n=this.readString(t.id),r=this.readString(t.generates);return!n||!r?null:{id:n,generates:r,description:this.readString(t.description)??`${this.humanizeStepName(n)} phase`,template:this.readString(t.template)??``,instruction:this.readString(t.instruction),requires:this.readStringArray(t.requires)}}normalizeApply(e){if(!e||typeof e!=`object`)return;let t=e;return{requires:this.readStringArray(t.requires),tracks:this.readString(t.tracks)??null,instruction:this.readString(t.instruction)}}readString(e){return typeof e==`string`&&e.trim().length>0?e:void 0}readStringArray(e){return Array.isArray(e)?e.filter(e=>typeof e==`string`&&e.length>0):[]}humanizeStepName(e){return e.split(/[-_]/g).filter(Boolean).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(` `)}};export{u as OpenSpecAdapter};

package/packages/flows/dist/builtins.d.ts

@@ -1,16 +0,0 @@
-import { FlowManifest } from "./types.js";
-
-//#region packages/flows/src/builtins.d.ts
-interface BuiltinFlow {
-  /** Flow manifest */
-  manifest: FlowManifest;
-  /** Relative path within the monorepo where scaffold files live */
-  scaffoldDir: string;
-}
-/**
- * Returns all built-in flow definitions bundled with @aikit/flows.
- * These flows are always available, even without installation via `flow add`.
- */
-declare function getBuiltinFlows(): BuiltinFlow[];
-//#endregion
-export { BuiltinFlow, getBuiltinFlows };

package/packages/flows/dist/builtins.js

@@ -1 +0,0 @@
-const e={name:`aikit:basic`,version:`0.1.0`,description:`Quick development flow for bug fixes, small features, and refactoring`,steps:[{id:`design`,name:`Design Gate`,instruction:`steps/design/README.md`,produces:[`design-decisions.md`],requires:[],agents:[`Researcher-Alpha`,`Researcher-Beta`,`Researcher-Gamma`,`Researcher-Delta`],description:`Evaluate task type, run brainstorming for features, FORGE classification. Auto-skips for bug fixes and refactors.`},{id:`assess`,name:`Assessment`,instruction:`steps/assess/README.md`,produces:[`assessment.md`],requires:[`design-decisions.md`],agents:[`Explorer`,`Researcher-Alpha`],description:`Understand scope, analyze codebase, identify approach`},{id:`implement`,name:`Implementation`,instruction:`steps/implement/README.md`,produces:[`progress.md`],requires:[`assessment.md`],agents:[`Implementer`,`Frontend`],description:`Write code following the assessment plan`},{id:`verify`,name:`Verification`,instruction:`steps/verify/README.md`,produces:[`verify-report.md`],requires:[`progress.md`],agents:[`Code-Reviewer-Alpha`,`Security`],description:`Review code, run tests, validate changes`}],agents:[],artifacts_dir:`.spec`,install:[]},t={name:`aikit:advanced`,version:`0.1.0`,description:`Full development flow for new features, API design, and architecture changes`,steps:[{id:`design`,name:`Design Gate`,instruction:`steps/design/README.md`,produces:[`design-decisions.md`],requires:[],agents:[`Researcher-Alpha`,`Researcher-Beta`,`Researcher-Gamma`,`Researcher-Delta`],description:`Full brainstorming, FORGE classification, decision protocol with parallel research. ADR for critical-tier tasks.`},{id:`spec`,name:`Specification`,instruction:`steps/spec/README.md`,produces:[`spec.md`],requires:[`design-decisions.md`],agents:[`Researcher-Alpha`],description:`Elicit requirements, clarify scope, define acceptance criteria`},{id:`plan`,name:`Planning`,instruction:`steps/plan/README.md`,produces:[`plan.md`],requires:[`spec.md`],agents:[`Planner`,`Explorer`],description:`Analyze codebase, design architecture, create implementation plan`},{id:`task`,name:`Task Breakdown`,instruction:`steps/task/README.md`,produces:[`tasks.md`],requires:[`plan.md`],agents:[`Planner`,`Architect-Reviewer-Alpha`],description:`Break plan into ordered implementation tasks with dependencies`},{id:`execute`,name:`Execution`,instruction:`steps/execute/README.md`,produces:[`progress.md`],requires:[`tasks.md`],agents:[`Orchestrator`,`Implementer`,`Frontend`,`Refactor`],description:`Implement all tasks, write code, write tests`},{id:`verify`,name:`Verification`,instruction:`steps/verify/README.md`,produces:[`verify-report.md`],requires:[`progress.md`],agents:[`Code-Reviewer-Alpha`,`Code-Reviewer-Beta`,`Architect-Reviewer-Alpha`,`Architect-Reviewer-Beta`,`Security`],description:`Dual code review, architecture review, security review, test validation`}],agents:[],artifacts_dir:`.spec`,install:[]};function n(){return[{manifest:e,scaffoldDir:`scaffold/flows/aikit-basic`},{manifest:t,scaffoldDir:`scaffold/flows/aikit-advanced`}]}export{n as getBuiltinFlows};

package/packages/flows/dist/foundation.d.ts

@@ -1,20 +0,0 @@
-import { FlowManifest } from "./types.js";
-
-//#region packages/flows/src/foundation.d.ts
-declare class FoundationIntegration {
-  /**
-   * Inject foundation preamble into a file.
-   * Replaces existing preamble if present, otherwise prepends.
-   */
-  injectPreamble(filePath: string, manifest: FlowManifest): void;
-  /**
-   * Remove foundation preamble from a file.
-   */
-  removePreamble(filePath: string): void;
-  /**
-   * Get list of IDE instruction files to inject preamble into.
-   */
-  getTargetFiles(workspaceRoot: string): string[];
-}
-//#endregion
-export { FoundationIntegration };

package/packages/flows/dist/foundation.js

@@ -1,11 +0,0 @@
-import{existsSync as e,readFileSync as t,writeFileSync as n}from"node:fs";import{join as r}from"node:path";const i=`<!-- aikit foundation context -->`,a=`<!-- end foundation context -->`;function o(e){let t=e.artifacts_dir||`.spec`;return`${i}
-You are operating within the @vpxa/aikit framework.
-- Use aikit MCP tools for all search, analysis, and memory operations
-- Follow agents defined in AGENTS.md for delegation
-- Use built-in skills (brainstorming, requirements-clarity, etc.) as needed
-- Track state via the flow state machine (flow_status, flow_step)
-- Active flow: ${e.name} v${e.version}
-- Artifacts go in: ${t}/${e.name}/
-${a}`}var s=class{injectPreamble(r,s){let c=o(s);if(!e(r)){n(r,`${c}\n`,`utf-8`);return}let l=t(r,`utf-8`),u=l.indexOf(i),d=l.indexOf(a);if(u!==-1&&d!==-1){n(r,`${l.slice(0,u)}${c}${l.slice(d+31)}`,`utf-8`);return}n(r,`${c}\n\n${l}`,`utf-8`)}removePreamble(r){if(!e(r))return;let o=t(r,`utf-8`),s=o.indexOf(i),c=o.indexOf(a);s===-1||c===-1||n(r,(o.slice(0,s)+o.slice(c+31)).replace(/^\n+/,``).replace(/\n{3,}/g,`
-
-`),`utf-8`)}getTargetFiles(t){let n=[],i=r(t,`.github`,`copilot-instructions.md`);e(i)&&n.push(i);let a=r(t,`CLAUDE.md`);e(a)&&n.push(a);let o=r(t,`AGENTS.md`);return e(o)&&n.push(o),n}};export{s as FoundationIntegration};

package/packages/flows/dist/git.d.ts

@@ -1,53 +0,0 @@
-import { FlowResult } from "./types.js";
-
-//#region packages/flows/src/git.d.ts
-declare class GitInstaller {
-  private readonly flowsDir;
-  constructor(flowsDir: string);
-  /**
-   * Clone a git repo into the flows directory.
-   * On auth failure, if GCM is available, retries interactively so the
-   * credential manager can open a browser / device-code flow.
-   * Returns the local install path.
-   */
-  clone(repoUrl: string, token?: string): FlowResult<string>;
-  /**
-   * Update an existing cloned flow repo.
-   */
-  update(installPath: string): FlowResult;
-  /**
-   * Copy a local directory as a flow source.
-   */
-  copyLocal(sourcePath: string, name: string): FlowResult<string>;
-  /**
-   * Remove installed flow files.
-   */
-  remove(installPath: string): FlowResult;
-  /**
-   * Run install dependencies for a flow.
-   * Processes the `install[]` field from flow.json.
-   */
-  runInstallDeps(installEntries: string[]): FlowResult;
-  /**
-   * Get the current HEAD commit SHA for a local git repo.
-   */
-  getLocalCommit(installPath: string): string | null;
-  /**
-   * Get the latest commit SHA on the remote default branch.
-   * Uses `git ls-remote` so it doesn't modify the working tree.
-   */
-  getRemoteCommit(installPath: string): string | null;
-  /**
-   * Check whether the remote has commits newer than the local HEAD.
-   */
-  hasUpdates(installPath: string): FlowResult<{
-    localCommit: string;
-    remoteCommit: string;
-    hasUpdates: boolean;
-  }>;
-  /** Extract repo name from git URL */
-  private repoNameFromUrl;
-  private ensureFlowsDir;
-}
-//#endregion
-export { GitInstaller };

package/packages/flows/dist/git.js

@@ -1,2 +0,0 @@
-import{cpSync as e,existsSync as t,mkdirSync as n,rmSync as r,unlinkSync as i,writeFileSync as a}from"node:fs";import{basename as o,join as s}from"node:path";import{execSync as c,spawnSync as l}from"node:child_process";import{tmpdir as u}from"node:os";function d(e){if(!e||typeof e!=`object`||!(`stderr`in e))return``;let t=e.stderr;return Buffer.isBuffer(t)?t.toString().trim():typeof t==`string`?t.trim():``}function f(e){try{return new URL(e).hostname}catch{}return e.match(/^[^@]+@([^:]+):/)?.[1]??`<host>`}function p(e,t,n){let r=[`Git operation failed for: ${e}`],i=f(e),a=t.includes(`ETIMEDOUT`)||t.includes(`SIGTERM`)||t.toLowerCase().includes(`timed out`),o=n.includes(`Authentication failed`)||n.includes(`could not read Username`)||n.includes(`terminal prompts disabled`)||n.includes(`401`)||n.includes(`403`)||n.includes(`Permission denied`),s=n.includes(`SSL certificate`)||n.includes(`unable to access`)&&n.includes(`SSL`),c=n.includes(`Could not resolve host`)||n.includes(`Name or service not known`),l=n.includes(`SAML`)||n.includes(`single sign-on`);return o||l?(r.push(``),r.push(`Cause: Authentication required or credentials not configured.`),r.push(``),r.push(`To fix this, ensure git can access this repository:`),r.push(``),r.push(`  Option 1 - SSH key:`),r.push(`    1. Generate an SSH key: ssh-keygen -t ed25519`),r.push(`    2. Add the public key to your Git hosting account`),r.push(`    3. Use the SSH URL instead: git@<host>:<org>/<repo>.git`),r.push(``),r.push(`  Option 2 - Personal Access Token (PAT):`),r.push(`    1. Create a PAT in your Git hosting Settings > Developer settings > Tokens`),r.push(`    2. For GitHub Enterprise with SAML SSO, authorize the token for your org`),r.push(`    3. Configure git credentials:`),r.push(`       git config --global credential.helper store`),r.push(`       git clone ${e}   (enter PAT as password)`),r.push(``),r.push(`  Option 3 - Git Credential Manager:`),r.push(`    1. Install: https://github.com/git-ecosystem/git-credential-manager`),r.push(`    2. Run: git clone ${e}`),r.push(`    3. Follow the browser-based auth prompt`),r.push(``),r.push(`After configuring credentials, retry: aikit flow add ${e}`)):a?(r.push(``),r.push(`Cause: Connection timed out - the server did not respond within 60 seconds.`),r.push(``),r.push(`Possible reasons:`),r.push(`  - The repository requires VPN access. Ensure your VPN is connected`),r.push(`  - The host is behind a firewall or corporate proxy`),r.push(`  - The URL may be incorrect`),r.push(``),r.push(`Diagnostics:`),r.push(`  1. Verify the URL is correct: ${e}`),r.push(`  2. Test connectivity: git ls-remote ${e}`),r.push(`  3. If behind a proxy, configure git:`),r.push(`     git config --global http.proxy http://proxy:port`),r.push(``),r.push(`If this is a corporate/internal host, you may need to:`),r.push(`  - Connect to the corporate VPN`),r.push(`  - Add the host to your SSH config or git config`),r.push(`  - Ask your IT team to allowlist your machine`),r.push(``),r.push(`After resolving, retry: aikit flow add ${e}`)):s?(r.push(``),r.push(`Cause: SSL/TLS certificate verification failed.`),r.push(``),r.push(`This often happens with corporate proxies or self-signed certificates.`),r.push(``),r.push(`To fix:`),r.push(`  1. If your company uses a custom CA, add it:`),r.push(`     git config --global http.sslCAInfo /path/to/ca-bundle.crt`),r.push(`  2. As a last resort (not recommended for production):`),r.push(`     git config --global http.sslVerify false`),r.push(``),r.push(`After resolving, retry: aikit flow add ${e}`)):c?(r.push(``),r.push(`Cause: Cannot resolve hostname.`),r.push(``),r.push(`Check:`),r.push(`  1. Is the URL correct? ${e}`),r.push(`  2. Are you connected to the internet/VPN?`),r.push(`  3. Can you resolve the host? ping ${i}`),r.push(``),r.push(`After resolving, retry: aikit flow add ${e}`)):(r.push(``),r.push(`Error: ${t}`),n&&r.push(`Details: ${n}`),r.push(``),r.push(`Troubleshooting:`),r.push(`  1. Verify the URL is a valid git repository: git ls-remote ${e}`),r.push(`  2. Check your git credentials and network connectivity`),r.push(`  3. If the repo requires auth, configure credentials first (PAT or SSH key)`),r.push(``),r.push(`After resolving, retry: aikit flow add ${e}`)),r.join(`
-`)}function m(){try{return l(`git`,[`credential-manager`,`--version`],{stdio:`pipe`,timeout:5e3}).status===0}catch{return!1}}function h(e,t){let n=`${e}\n${t}`.toLowerCase();return n.includes(`authentication failed`)||n.includes(`could not read username`)||n.includes(`saml sso`)||n.includes(`terminal prompts disabled`)||n.includes(`host key verification failed`)||n.includes(`permission denied`)||n.includes(`403`)||n.includes(`401`)}var g=class{constructor(e){this.flowsDir=e}clone(e,n){let o=this.repoNameFromUrl(e),c=s(this.flowsDir,o);if(t(c))if(!t(s(c,`.git`)))r(c,{recursive:!0,force:!0});else return{success:!1,error:`Flow "${o}" already installed at ${c}. Use update instead.`};try{if(this.ensureFlowsDir(),n){let t=process.platform===`win32`?`bat`:`sh`,r=s(u(),`git-askpass-${Date.now()}.${t}`);process.platform===`win32`?a(r,`@echo ${n}`,{mode:448}):a(r,`#!/bin/sh\necho "${n}"`,{mode:448});try{let t=l(`git`,[`clone`,`--depth`,`1`,e,c],{stdio:`pipe`,timeout:6e4,env:{...process.env,GIT_TERMINAL_PROMPT:`0`,GIT_ASKPASS:r}});if(t.status!==0){let e=t.stderr?.toString().trim()??``;throw Error(e||t.error?.message||`git clone failed`)}}finally{try{i(r)}catch{}}}else{let t=l(`git`,[`clone`,`--depth`,`1`,e,c],{stdio:`pipe`,timeout:6e4,env:{...process.env,GIT_TERMINAL_PROMPT:`0`,GIT_ASKPASS:``}});if(t.status!==0){let e=t.stderr?.toString().trim()??``;throw Error(e||t.error?.message||`git clone failed`)}}return{success:!0,data:c}}catch(i){t(c)&&r(c,{recursive:!0,force:!0});let a=d(i),o=i instanceof Error?i.message:String(i);if(!n&&h(o,a)&&m()){let n=f(e)||e;console.log(`\nAuthentication required for ${n}.\nGit Credential Manager detected - opening browser for login...\n(If a browser window does not open, check your terminal for a device code.)\n`);try{if(this.ensureFlowsDir(),l(`git`,[`clone`,`--depth`,`1`,e,c],{stdio:`inherit`,timeout:12e4,env:{...process.env,GIT_TERMINAL_PROMPT:`1`}}).status===0)return{success:!0,data:c};t(c)&&r(c,{recursive:!0,force:!0})}catch{t(c)&&r(c,{recursive:!0,force:!0})}}return{success:!1,error:p(e,o,a)}}}update(e){if(!t(e))return{success:!1,error:`Install path not found: ${e}`};try{return c(`git pull --ff-only`,{cwd:e,stdio:`pipe`,timeout:6e4,env:{...process.env,GIT_TERMINAL_PROMPT:`0`,GIT_ASKPASS:``}}),{success:!0}}catch(t){let n=e;try{n=c(`git remote get-url origin`,{cwd:e,stdio:`pipe`,timeout:1e4}).toString().trim()}catch{}let r=d(t),i=t instanceof Error?t.message:String(t);if(h(i,r)&&m()){let t=f(n)||n;console.log(`\nAuthentication required for ${t}.\nGit Credential Manager detected - opening browser for login...\n`);try{if(l(`git`,[`pull`,`--ff-only`],{cwd:e,stdio:`inherit`,timeout:12e4,env:{...process.env,GIT_TERMINAL_PROMPT:`1`}}).status===0)return{success:!0}}catch{}}return{success:!1,error:p(n,i,r)}}}copyLocal(n,r){let i=s(this.flowsDir,r);if(t(i))return{success:!1,error:`Flow "${r}" already installed at ${i}`};try{return this.ensureFlowsDir(),e(n,i,{recursive:!0}),{success:!0,data:i}}catch(e){return{success:!1,error:`Copy failed: ${e instanceof Error?e.message:String(e)}`}}}remove(e){if(!t(e))return{success:!0};try{return r(e,{recursive:!0,force:!0}),{success:!0}}catch(e){return{success:!1,error:`Remove failed: ${e instanceof Error?e.message:String(e)}`}}}runInstallDeps(e){for(let t of e)try{if(t.startsWith(`npm:`)){c(`npx skills add ${t.slice(4)} -g`,{stdio:`pipe`,timeout:12e4});continue}if(t.endsWith(`.git`)||t.includes(`github.com`)){c(`npx skills add ${t} -g`,{stdio:`pipe`,timeout:12e4});continue}return{success:!1,error:`Unknown install entry format: ${t}`}}catch(e){return{success:!1,error:`Install dependency failed for "${t}": ${e instanceof Error?e.message:String(e)}`}}return{success:!0}}getLocalCommit(e){try{return c(`git rev-parse HEAD`,{cwd:e,stdio:`pipe`,timeout:1e4,env:{...process.env,GIT_TERMINAL_PROMPT:`0`}}).toString().trim()||null}catch{return null}}getRemoteCommit(e){try{return c(`git ls-remote origin HEAD`,{cwd:e,stdio:`pipe`,timeout:3e4,env:{...process.env,GIT_TERMINAL_PROMPT:`0`}}).toString().trim().split(/\s+/)[0]||null}catch{return null}}hasUpdates(e){let t=this.getLocalCommit(e);if(!t)return{success:!1,error:`Could not determine local commit (not a git repo?)`};let n=this.getRemoteCommit(e);return n?{success:!0,data:{localCommit:t,remoteCommit:n,hasUpdates:t!==n}}:{success:!1,error:`Could not reach remote to check for updates`}}repoNameFromUrl(e){return o(e).replace(/\.git$/,``)}ensureFlowsDir(){t(this.flowsDir)||n(this.flowsDir,{recursive:!0})}};export{g as GitInstaller};

package/packages/flows/dist/loader.d.ts

@@ -1,13 +0,0 @@
-import { FlowFormat, FlowManifest, FlowParseOptions, FlowResult } from "./types.js";
-
-//#region packages/flows/src/loader.d.ts
-declare class FlowLoader {
-  load(sourceDir: string, options?: FlowParseOptions): Promise<FlowResult<{
-    manifest: FlowManifest;
-    format: FlowFormat;
-  }>>;
-  loadWithFormat(sourceDir: string, format: FlowFormat, options?: FlowParseOptions): Promise<FlowResult<FlowManifest>>;
-  validate(manifest: FlowManifest): FlowResult;
-}
-//#endregion
-export { FlowLoader };

package/packages/flows/dist/loader.js

@@ -1,2 +0,0 @@
-import{getAdapter as e,getAdapterForSource as t}from"./adapters/index.js";import{existsSync as n}from"node:fs";var r=class{async load(e,r){if(!n(e))return{success:!1,error:`Source directory not found: ${e}`};let i=t(e);if(!i)return{success:!1,error:`No format adapter matches source: ${e}`};try{let t=await i.parse(e,r),n=this.validate(t);return n.success?{success:!0,data:{manifest:t,format:i.format}}:n}catch(e){return{success:!1,error:`Failed to parse flow: ${e instanceof Error?e.message:String(e)}`}}}async loadWithFormat(t,n,r){let i=e(n);try{let e=await i.parse(t,r),n=this.validate(e);return n.success?{success:!0,data:e}:n}catch(e){return{success:!1,error:`Failed to parse flow: ${e instanceof Error?e.message:String(e)}`}}}validate(e){let t=[];e.name?.trim()||t.push(`Missing flow name`),e.version?.trim()||t.push(`Missing flow version`),e.steps?.length||t.push(`Flow must have at least one step`);let n=new Set(e.steps.map(e=>e.id));for(let r of e.steps??[]){r.id?.trim()||t.push(`Step missing id`),r.instruction?.trim()||t.push(`Step "${r.id}" missing instruction path`);for(let e of r.requires??[])n.has(e)||t.push(`Step "${r.id}" requires unknown step "${e}"`)}return n.size!==(e.steps?.length??0)&&t.push(`Duplicate step IDs found`),t.length>0?{success:!1,error:`Validation failed:\n${t.join(`
-`)}`}:{success:!0}}};export{r as FlowLoader};

package/packages/flows/dist/registry.d.ts

@@ -1,23 +0,0 @@
-import { FlowRegistry, FlowRegistryEntry, FlowResult } from "./types.js";
-
-//#region packages/flows/src/registry.d.ts
-declare class FlowRegistryManager {
-  private readonly registryPath;
-  constructor(registryPath: string);
-  /** Load registry from disk, or create empty if missing */
-  load(): FlowRegistry;
-  /** Save registry to disk */
-  save(registry: FlowRegistry): void;
-  /** Register a new flow or update an existing one */
-  register(entry: FlowRegistryEntry): FlowResult;
-  /** Remove a flow from the registry */
-  unregister(name: string): FlowResult;
-  /** Get a specific flow entry (checks disk registry first, then builtins) */
-  get(name: string): FlowRegistryEntry | null;
-  /** List all registered flows (disk + builtins, disk overrides builtins) */
-  list(): FlowRegistryEntry[];
-  /** Check if a flow is registered (disk or builtin) */
-  has(name: string): boolean;
-}
-//#endregion
-export { FlowRegistryManager };

package/packages/flows/dist/registry.js

@@ -1 +0,0 @@
-import{getBuiltinFlows as e}from"./builtins.js";import{existsSync as t,mkdirSync as n,readFileSync as r,writeFileSync as i}from"node:fs";import{dirname as a}from"node:path";function o(){return e().map(e=>({name:e.manifest.name,version:e.manifest.version,source:`builtin`,sourceType:`builtin`,installPath:e.scaffoldDir,format:`native`,registeredAt:`1970-01-01T00:00:00.000Z`,updatedAt:`1970-01-01T00:00:00.000Z`,manifest:e.manifest}))}var s=class{constructor(e){this.registryPath=e}load(){if(!t(this.registryPath))return{version:1,flows:{}};try{let e=r(this.registryPath,`utf-8`);return JSON.parse(e)}catch{return{version:1,flows:{}}}}save(e){let r=a(this.registryPath);t(r)||n(r,{recursive:!0}),i(this.registryPath,JSON.stringify(e,null,2),`utf-8`)}register(e){let t=this.load();return t.flows[e.name]=e,this.save(t),{success:!0}}unregister(e){let t=this.load();return t.flows[e]?(delete t.flows[e],this.save(t),{success:!0}):{success:!1,error:`Flow "${e}" not found in registry`}}get(e){return this.load().flows[e]||(o().find(t=>t.name===e)??null)}list(){let e=this.load(),t=new Set(Object.keys(e.flows)),n=Object.values(e.flows);for(let e of o())t.has(e.name)||n.push(e);return n}has(e){return e in this.load().flows?!0:o().some(t=>t.name===e)}};export{s as FlowRegistryManager};

package/packages/flows/dist/state-machine.d.ts

@@ -1,23 +0,0 @@
-import { FlowManifest, FlowResult, FlowState, StepAction } from "./types.js";
-
-//#region packages/flows/src/state-machine.d.ts
-declare class FlowStateMachine {
-  private readonly statePath;
-  constructor(statePath: string);
-  /** Load active flow state from disk, or null if no active flow */
-  load(): FlowState | null;
-  /** Save state to disk */
-  private save;
-  /** Start a new flow */
-  start(flowName: string, manifest: FlowManifest): FlowResult<FlowState>;
-  /** Advance the flow: next, skip, or redo current step */
-  step(action: StepAction, manifest: FlowManifest): FlowResult<FlowState>;
-  /** Get current flow status */
-  getStatus(): FlowResult<FlowState>;
-  /** Reset flow state (clear active flow) */
-  reset(): FlowResult;
-  /** Record an artifact produced by a step */
-  recordArtifact(name: string, path: string): FlowResult;
-}
-//#endregion
-export { FlowStateMachine };

package/packages/flows/dist/state-machine.js

@@ -1 +0,0 @@
-import{existsSync as e,mkdirSync as t,readFileSync as n,unlinkSync as r,writeFileSync as i}from"node:fs";import{dirname as a}from"node:path";var o=class{constructor(e){this.statePath=e}load(){if(!e(this.statePath))return null;try{let e=n(this.statePath,`utf-8`);return JSON.parse(e)}catch{return null}}save(n){let r=a(this.statePath);e(r)||t(r,{recursive:!0}),i(this.statePath,JSON.stringify(n,null,2),`utf-8`)}start(e,t){let n=this.load();if(n&&n.status===`active`)return{success:!1,error:`Flow "${n.flow}" is already active. Reset it first.`};if(!t.steps.length)return{success:!1,error:`Flow has no steps`};let r=new Date().toISOString(),i={flow:e,status:`active`,currentStep:t.steps[0].id,completedSteps:[],skippedSteps:[],artifacts:{},startedAt:r,updatedAt:r};return this.save(i),{success:!0,data:i}}step(e,t){let n=this.load();if(!n)return{success:!1,error:`No active flow`};if(n.status!==`active`)return{success:!1,error:`Flow is ${n.status}, not active`};if(!n.currentStep)return{success:!1,error:`No current step`};let r=t.steps.findIndex(e=>e.id===n.currentStep);if(r===-1)return{success:!1,error:`Current step "${n.currentStep}" not found in manifest`};let i=new Date().toISOString();switch(e){case`next`:{n.completedSteps.includes(n.currentStep)||n.completedSteps.push(n.currentStep);let e=r+1;e>=t.steps.length?(n.currentStep=null,n.status=`completed`):n.currentStep=t.steps[e].id;break}case`skip`:{n.skippedSteps.includes(n.currentStep)||n.skippedSteps.push(n.currentStep);let e=r+1;e>=t.steps.length?(n.currentStep=null,n.status=`completed`):n.currentStep=t.steps[e].id;break}case`redo`:n.completedSteps=n.completedSteps.filter(e=>e!==n.currentStep),n.skippedSteps=n.skippedSteps.filter(e=>e!==n.currentStep);break}return n.updatedAt=i,this.save(n),{success:!0,data:n}}getStatus(){let e=this.load();return e?{success:!0,data:e}:{success:!1,error:`No active flow`}}reset(){return e(this.statePath)&&r(this.statePath),{success:!0}}recordArtifact(e,t){let n=this.load();return n?(n.artifacts[e]=t,n.updatedAt=new Date().toISOString(),this.save(n),{success:!0}):{success:!1,error:`No active flow`}}};export{o as FlowStateMachine};

package/packages/flows/dist/symlinks.d.ts

@@ -1,17 +0,0 @@
-import { FlowManifest } from "./types.js";
-
-//#region packages/flows/src/symlinks.d.ts
-declare class SymlinkManager {
-  /**
-   * Create agent symlinks for a flow in the workspace.
-   */
-  createSymlinks(workspaceRoot: string, flowName: string, flowInstallPath: string, manifest: FlowManifest): void;
-  /**
-   * Remove agent symlinks for a flow.
-   */
-  removeSymlinks(workspaceRoot: string, flowName: string): void;
-  private getTargets;
-  private getAgentStem;
-}
-//#endregion
-export { SymlinkManager };

package/packages/flows/dist/symlinks.js

@@ -1 +0,0 @@
-import{copyFileSync as e,existsSync as t,mkdirSync as n,readdirSync as r,rmdirSync as i,symlinkSync as a,unlinkSync as o}from"node:fs";import{basename as s,dirname as c,join as l,relative as u}from"node:path";var d=class{createSymlinks(r,i,s,d){let f=this.getTargets(r,i);for(let r of f){t(r.baseDir)||n(r.baseDir,{recursive:!0});for(let n of d.agents){let i=l(s,n);if(!t(i))continue;let d=this.getAgentStem(n),f=l(r.baseDir,`${d}${r.extension}`);t(f)&&o(f);let p=u(c(f),i);try{a(p,f,`file`)}catch{try{e(i,f)}catch(e){console.warn(`Failed to create symlink or copy fallback for ${i}: ${e instanceof Error?e.message:String(e)}`)}}}}}removeSymlinks(e,n){let a=this.getTargets(e,n);for(let e of a)if(t(e.baseDir))try{let t=r(e.baseDir,{withFileTypes:!0});for(let n of t)!n.isFile()&&!n.isSymbolicLink()||o(l(e.baseDir,n.name));r(e.baseDir).length===0&&i(e.baseDir)}catch{}}getTargets(e,t){return[{ide:`copilot`,baseDir:l(e,`.github`,`agents`,`flows`,t),extension:`.agent.md`},{ide:`claude-code`,baseDir:l(e,`.claude`,`agents`,`flows`,t),extension:`.md`}]}getAgentStem(e){return s(e).replace(/\.agent\.md$/,``).replace(/\.md$/,``)}};export{d as SymlinkManager};

package/packages/flows/dist/types.d.ts

@@ -1,127 +0,0 @@
-//#region packages/flows/src/types.d.ts
-/**
- * @aikit/flows — Type definitions for the pluggable flow system.
- */
-/** A single step in a flow */
-interface FlowStep {
-  /** Unique step identifier within the flow (e.g., "spec", "plan", "execute") */
-  id: string;
-  /** Human-readable step name */
-  name: string;
-  /** Relative path to the step's instruction file */
-  instruction: string;
-  /** Artifact filenames this step produces */
-  produces: string[];
-  /** Step IDs this step depends on (must be completed first) */
-  requires: string[];
-  /** Agent files specific to this step (relative paths) */
-  agents: string[];
-  /** Step description */
-  description: string;
-}
-/** Flow manifest — the flow.json schema */
-interface FlowManifest {
-  /** Flow name (unique identifier) */
-  name: string;
-  /** Semantic version */
-  version: string;
-  /** Human-readable description */
-  description: string;
-  /** Author name or organization */
-  author?: string;
-  /** Ordered list of steps */
-  steps: FlowStep[];
-  /** Flow-level agent files (relative paths) */
-  agents: string[];
-  /** Directory for artifacts (default: ".spec") */
-  artifacts_dir: string;
-  /** External dependencies to install at flow-add time */
-  install: string[];
-}
-/** Source type for flow installation */
-type FlowSourceType = 'builtin' | 'git' | 'local' | 'npm-global' | 'claude-plugin';
-/** Detected format of the flow source */
-type FlowFormat = 'native' | 'claude-plugin' | 'copilot' | 'openspec';
-type ContentTransformFn = (request: {
-  content: string;
-  sourceFormat: FlowFormat;
-  stepName: string;
-  metadata?: Record<string, unknown>;
-}) => Promise<string>;
-/** Registry entry for an installed flow */
-interface FlowRegistryEntry {
-  /** Flow name */
-  name: string;
-  /** Flow version */
-  version: string;
-  /** Original source (URL, path, or "builtin") */
-  source: string;
-  /** How the flow was installed */
-  sourceType: FlowSourceType;
-  /** Absolute path where flow files are stored */
-  installPath: string;
-  /** Detected source format */
-  format: FlowFormat;
-  /** ISO timestamp when registered */
-  registeredAt: string;
-  /** ISO timestamp of last update */
-  updatedAt: string;
-  /** Parsed manifest (cached) */
-  manifest: FlowManifest;
-  /** Git commit SHA of the installed version (git sources only) */
-  commitSha?: string;
-}
-/** The flow registry file structure */
-interface FlowRegistry {
-  /** Schema version */
-  version: 1;
-  /** Map of flow name → registry entry */
-  flows: Record<string, FlowRegistryEntry>;
-}
-/** Flow execution state */
-type FlowStatus = 'idle' | 'active' | 'completed';
-/** Active flow state (persisted to state.json) */
-interface FlowState {
-  /** Which flow is active (name from registry) */
-  flow: string;
-  /** Current status */
-  status: FlowStatus;
-  /** Current step ID (null if not started) */
-  currentStep: string | null;
-  /** Completed step IDs in order */
-  completedSteps: string[];
-  /** Skipped step IDs */
-  skippedSteps: string[];
-  /** Map of artifact name → file path */
-  artifacts: Record<string, string>;
-  /** ISO timestamp when flow was started */
-  startedAt: string;
-  /** ISO timestamp of last state change */
-  updatedAt: string;
-}
-/** Step action for state machine transitions */
-type StepAction = 'next' | 'skip' | 'redo';
-/** Options passed to format adapter parse */
-interface FlowParseOptions {
-  /** When true, force-refresh supporting assets (e.g. on update) */
-  forceAssetSync?: boolean;
-  /** Optional content transformer for converting foreign step content to native README.md */
-  transform?: ContentTransformFn;
-}
-/** Format adapter interface — converts external formats to FlowManifest */
-interface FlowFormatAdapter {
-  /** Format name */
-  readonly format: FlowFormat;
-  /** Check if a directory matches this format */
-  detect(sourceDir: string): boolean;
-  /** Parse the source directory into a FlowManifest */
-  parse(sourceDir: string, options?: FlowParseOptions): Promise<FlowManifest>;
-}
-/** Result of a flow operation */
-interface FlowResult<T = void> {
-  success: boolean;
-  data?: T;
-  error?: string;
-}
-//#endregion
-export { ContentTransformFn, FlowFormat, FlowFormatAdapter, FlowManifest, FlowParseOptions, FlowRegistry, FlowRegistryEntry, FlowResult, FlowSourceType, FlowState, FlowStatus, FlowStep, StepAction };

package/packages/flows/dist/types.js

@@ -1 +0,0 @@
-export{};

package/packages/indexer/dist/file-hasher.d.ts

@@ -1,13 +0,0 @@
-//#region packages/indexer/src/file-hasher.d.ts
-/**
- * Generate a deterministic hash for a file's content.
- * Used for incremental indexing -- skip files that haven't changed.
- */
-declare function hashContent(content: string): string;
-/**
- * Generate a deterministic ID for a knowledge record.
- * Based on source path + chunk index to ensure idempotent upserts.
- */
-declare function generateRecordId(sourcePath: string, chunkIndex: number): string;
-//#endregion
-export { generateRecordId, hashContent };

package/packages/indexer/dist/file-hasher.js

@@ -1 +0,0 @@
-import{createHash as e}from"node:crypto";function t(t){return e(`sha256`).update(t).digest(`hex`).slice(0,16)}function n(t,n){let r=`${t}:${n}`;return e(`sha256`).update(r).digest(`hex`).slice(0,16)}export{n as generateRecordId,t as hashContent};

package/packages/indexer/dist/filesystem-crawler.d.ts

@@ -1,29 +0,0 @@
-//#region packages/indexer/src/filesystem-crawler.d.ts
-interface CrawlResult {
-  /** File path relative to workspace root */
-  relativePath: string;
-  /** Absolute file path */
-  absolutePath: string;
-  /** File content */
-  content: string;
-  /** File extension (lowercase, with dot) */
-  extension: string;
-}
-interface CrawlOptions {
-  /** Glob patterns to exclude */
-  excludePatterns: string[];
-  /** Root directory to crawl */
-  rootDir: string;
-}
-/**
- * Crawl a directory tree and yield files that should be indexed.
- */
-declare class FilesystemCrawler {
-  /** Binary file extensions that should always be skipped */
-  private static readonly BINARY_EXTENSIONS;
-  crawl(options: CrawlOptions): Promise<CrawlResult[]>;
-  private walkDir;
-  private isExcluded;
-}
-//#endregion
-export { CrawlOptions, CrawlResult, FilesystemCrawler };

package/packages/indexer/dist/filesystem-crawler.js

@@ -1 +0,0 @@
-import{realpathSync as e}from"node:fs";import{lstat as t,readFile as n,readdir as r,stat as i}from"node:fs/promises";import{extname as a,join as o,relative as s}from"node:path";import{AIKIT_PATHS as c,FILE_LIMITS as l,createLogger as u}from"../../core/dist/index.js";import{minimatch as d}from"minimatch";const f=u(`indexer`);var p=class u{static BINARY_EXTENSIONS=new Set(`.node,.so,.dylib,.dll,.wasm,.bin,.exe,.png,.jpg,.jpeg,.gif,.bmp,.ico,.webp,.svg,.mp3,.mp4,.wav,.avi,.mov,.flac,.zip,.gz,.tar,.bz2,.7z,.rar,.pdf,.doc,.docx,.xls,.xlsx,.ppt,.pptx,.ttf,.otf,.woff,.woff2,.eot,.pyc,.class,.o,.obj,.a,.lib`.split(`,`));async crawl(e){let t=[],n=new Set;return await this.walkDir(e.rootDir,e.rootDir,e.excludePatterns,t,n),t}async walkDir(d,p,m,h,g){let _;try{_=await r(d,{withFileTypes:!0})}catch(e){let t=e.code;(t===`EACCES`||t===`EPERM`)&&f.warn(`Permission denied, skipping directory`,{dir:d});return}for(let r of _){let f=o(d,r.name),_=s(p,f).replace(/\\/g,`/`);if(!this.isExcluded(_,m)){if(r.isDirectory()){if(r.name.startsWith(`.`)&&!(r.name===c.ai.slice(1)&&_.startsWith(c.ai)))continue;try{if((await t(f)).isSymbolicLink())continue}catch{continue}let n;try{n=e(f)}catch{continue}if(g.has(n))continue;g.add(n),await this.walkDir(f,p,m,h,g)}else if(r.isFile()){let e=a(r.name).toLowerCase();if(u.BINARY_EXTENSIONS.has(e))continue;try{if((await i(f)).size>l.maxFileSizeBytes)continue;let t=await n(f,`utf-8`);if(t.includes(`\0`))continue;h.push({relativePath:_,absolutePath:f,content:t,extension:e})}catch{}}}}}isExcluded(e,t){return t.some(t=>d(e,t,{dot:!0}))}};export{p as FilesystemCrawler};

package/packages/indexer/dist/graph-extractor.d.ts

@@ -1,22 +0,0 @@
-import { GraphEdge, GraphNode } from "../../store/dist/index.js";
-
-//#region packages/indexer/src/graph-extractor.d.ts
-interface ExtractGraphOptions {
-  /** Maps workspace package names to entry module paths without extensions. */
-  workspacePackages?: Map<string, string>;
-}
-interface ExtractedGraph {
-  nodes: GraphNode[];
-  edges: GraphEdge[];
-}
-/**
- * Extract graph nodes and edges from a single file's content.
- * Produces:
- * - One "module" node per file
- * - Symbol nodes (function, class, interface, type, const, enum)
- * - "defines" edges from module → symbol
- * - "imports" edges from module → imported module
- */
-declare function extractGraph(content: string, sourcePath: string, options?: ExtractGraphOptions): ExtractedGraph;
-//#endregion
-export { ExtractGraphOptions, ExtractedGraph, extractGraph };

package/packages/indexer/dist/graph-extractor.js

@@ -1 +0,0 @@
-import{createHash as e}from"node:crypto";import{dirname as t,extname as n,join as r}from"node:path";const i=new Set([`.ts`,`.tsx`,`.js`,`.jsx`,`.mjs`,`.cjs`]),a=[{pattern:/^export\s+(?:async\s+)?function\s+(\w+)/gm,kind:`function`,exported:!0},{pattern:/^export\s+(?:default\s+)?class\s+(\w+)/gm,kind:`class`,exported:!0},{pattern:/^export\s+interface\s+(\w+)/gm,kind:`interface`,exported:!0},{pattern:/^export\s+type\s+(\w+)/gm,kind:`type`,exported:!0},{pattern:/^export\s+(?:const|let)\s+(\w+)/gm,kind:`const`,exported:!0},{pattern:/^export\s+enum\s+(\w+)/gm,kind:`enum`,exported:!0},{pattern:/^(?:async\s+)?function\s+(\w+)/gm,kind:`function`,exported:!1},{pattern:/^class\s+(\w+)/gm,kind:`class`,exported:!1},{pattern:/^interface\s+(\w+)/gm,kind:`interface`,exported:!1},{pattern:/^type\s+(\w+)/gm,kind:`type`,exported:!1},{pattern:/^enum\s+(\w+)/gm,kind:`enum`,exported:!1}],o=[/import\s+(?:(?:type\s+)?(?:(?:\{[^}]*\}|[\w*]+)\s+from\s+)?)['"]([^'"]+)['"]/g,/import\(\s*['"]([^'"]+)['"]\s*\)/g,/require\(\s*['"]([^'"]+)['"]\s*\)/g];function s(t,n,r){return e(`sha256`).update(`${t}:${n}:${r}`).digest(`hex`).slice(0,16)}function c(t,n,r){return e(`sha256`).update(`${t}-${r}-${n}`).digest(`hex`).slice(0,16)}function l(e,n){return r(t(n),e).replace(/\\/g,`/`).replace(/\.(js|jsx|ts|tsx|mjs|cjs)$/,``)}function u(e){return e.replace(/\.(js|jsx|ts|tsx|mjs|cjs)$/,``)}function d(e,t,r){let d=n(t).toLowerCase();if(!i.has(d))return{nodes:[],edges:[]};let f=[],p=[],m=new Date().toISOString(),h=new Set,g=u(t),_=s(`module`,g,g);f.push({id:_,type:`module`,name:t,properties:{ext:d},sourcePath:t,createdAt:m});for(let{pattern:n,kind:r,exported:i}of a){let a=new RegExp(n.source,n.flags),o;for(;(o=a.exec(e))!==null;){let e=o[1],n=`${r}:${e}`;if(h.has(n))continue;h.add(n);let a=s(r,e,t);f.push({id:a,type:r,name:e,properties:{exported:i},sourcePath:t,createdAt:m}),p.push({id:c(_,a,`defines`),fromId:_,toId:a,type:`defines`,weight:i?1:.5})}}let v=r?.workspacePackages,y=new Set;for(let n of o){let r=new RegExp(n.source,n.flags),i;for(;(i=r.exec(e))!==null;){let e=i[1];if(y.has(e))continue;let n;if(e.startsWith(`.`))n=l(e,t);else if(v){let t=e.startsWith(`@`)?e.split(`/`).slice(0,2).join(`/`):e.split(`/`)[0],r=v.get(t);if(!r)continue;n=r}else continue;y.add(e);let r=u(n),a=s(`module`,r,r);p.push({id:c(_,a,`imports`),fromId:_,toId:a,type:`imports`,properties:{source:e}})}}return{nodes:f,edges:p}}export{d as extractGraph};

package/packages/indexer/dist/hash-cache.d.ts

@@ -1,24 +0,0 @@
-//#region packages/indexer/src/hash-cache.d.ts
-/**
- * Persistent file hash cache.
- * Stores path->hash mappings in a JSON file to avoid LanceDB round-trips
- * when checking which files have changed during incremental indexing.
- */
-declare class FileHashCache {
-  private cache;
-  private readonly filePath;
-  private dirty;
-  constructor(storeDir: string);
-  /** Load cache from disk. Non-fatal if missing or corrupt. */
-  load(): void;
-  get(path: string): string | undefined;
-  set(path: string, hash: string): void;
-  delete(path: string): void;
-  /** Persist cache to disk if changed. */
-  flush(): void;
-  /** Clear all entries and delete file. */
-  clear(): void;
-  get size(): number;
-}
-//#endregion
-export { FileHashCache };

package/packages/indexer/dist/hash-cache.js

@@ -1 +0,0 @@
-import{existsSync as e,readFileSync as t,writeFileSync as n}from"node:fs";import{resolve as r}from"node:path";import{createLogger as i}from"../../core/dist/index.js";const a=i(`hash-cache`);var o=class{cache;filePath;dirty=!1;constructor(e){this.filePath=r(e,`file-hashes.json`),this.cache=new Map}load(){if(e(this.filePath))try{let e=t(this.filePath,`utf-8`),n=JSON.parse(e);this.cache=new Map(Object.entries(n)),a.info(`Hash cache loaded`,{entries:this.cache.size})}catch(e){a.warn(`Hash cache load failed, starting fresh`,{err:e}),this.cache=new Map}}get(e){return this.cache.get(e)}set(e,t){this.cache.set(e,t),this.dirty=!0}delete(e){this.cache.delete(e)&&(this.dirty=!0)}flush(){if(this.dirty)try{let e={};for(let[t,n]of this.cache)e[t]=n;n(this.filePath,JSON.stringify(e),`utf-8`),this.dirty=!1}catch(e){a.warn(`Hash cache flush failed`,{err:e})}}clear(){this.cache.clear(),this.dirty=!0,this.flush()}get size(){return this.cache.size}};export{o as FileHashCache};

package/packages/indexer/dist/incremental-indexer.d.ts

@@ -1,73 +0,0 @@
-import { FileHashCache } from "./hash-cache.js";
-import { IndexStats, KBConfig } from "../../core/dist/index.js";
-import { IGraphStore, IKnowledgeStore } from "../../store/dist/index.js";
-import { IEmbedder } from "../../embeddings/dist/index.js";
-
-//#region packages/indexer/src/incremental-indexer.d.ts
-interface IndexProgress {
-  phase: 'crawling' | 'chunking' | 'embedding' | 'storing' | 'cleanup' | 'done';
-  filesTotal: number;
-  filesProcessed: number;
-  chunksTotal: number;
-  chunksProcessed: number;
-  /** The file currently being processed */
-  currentFile?: string;
-}
-type ProgressCallback = (progress: IndexProgress) => void;
-interface IndexResult {
-  filesProcessed: number;
-  filesSkipped: number;
-  chunksCreated: number;
-  filesRemoved: number;
-  durationMs: number;
-}
-declare class IncrementalIndexer {
-  private readonly embedder;
-  private readonly store;
-  private readonly crawler;
-  private indexing;
-  private graphStore?;
-  private hashCache?;
-  /** Whether an index operation is currently in progress. */
-  get isIndexing(): boolean;
-  constructor(embedder: IEmbedder, store: IKnowledgeStore);
-  /** Set the graph store for auto-population during indexing and cleanup on re-index. */
-  setGraphStore(graphStore: IGraphStore): void;
-  /** Set the hash cache for faster incremental checks. */
-  setHashCache(cache: FileHashCache): void;
-  /**
-   * Index all configured sources. Only re-indexes files that have changed.
-   * Sources are crawled in parallel, and file processing runs concurrently
-   * up to `config.indexing.concurrency` (default: 50% of CPU cores, minimum 2, maximum 4).
-   */
-  index(config: KBConfig, onProgress?: ProgressCallback): Promise<IndexResult>;
-  /**
-   * Crawl sources and return file paths whose content has changed since the last index.
-   * This performs a read-only scan and does not modify the store.
-   */
-  getChangedFiles(config: KBConfig): Promise<string[]>;
-  /**
-   * Index only the specified file paths.
-   * Files that have not changed are skipped.
-   */
-  indexFiles(config: KBConfig, paths: string[], onProgress?: ProgressCallback): Promise<IndexResult>;
-  private doIndex;
-  private doIndexFiles;
-  private crawlSources;
-  private planIndexWork;
-  private getPathsToRemove;
-  private buildWorkspacePackageMap;
-  private processFiles;
-  private cleanupRemovedFiles;
-  /**
-   * Force re-index all files (ignoring hashes).
-   */
-  reindexAll(config: KBConfig, onProgress?: ProgressCallback): Promise<IndexResult>;
-  private doReindex;
-  /**
-   * Get current index statistics.
-   */
-  getStats(): Promise<IndexStats>;
-}
-//#endregion
-export { IncrementalIndexer, IndexProgress, IndexResult, ProgressCallback };