@akanjs/devkit 3.0.0-alpha.11 → 3.0.0-alpha.110

package/src/capacitorApp.ts

@@ -1,282 +0,0 @@
-import type { AppExecutor } from "@akanjs/devkit/executors";
-import { FileSys } from "@akanjs/devkit/fileSys";
-import type { CapacitorConfig } from "@capacitor/cli";
-import { MobileProject } from "@trapezedev/project";
-import type { AndroidProject } from "@trapezedev/project/dist/android/project";
-import type { IosProject } from "@trapezedev/project/dist/ios/project";
-import { capitalize } from "akanjs/common";
-
-import { FileEditor } from "./fileEditor";
-
-interface RunConfig extends CapacitorConfig {
-  operation: "local" | "release";
-  version: string;
-  buildNum: number;
-  appId?: string;
-  host?: "local" | "debug" | "develop" | "main";
-}
-
-export class CapacitorApp {
-  project: MobileProject & { ios: IosProject; android: AndroidProject };
-  iosTargetName = "App";
-  constructor(private readonly app: AppExecutor) {
-    this.project = new MobileProject(this.app.cwdPath, {
-      android: { path: "android" },
-      ios: { path: "ios/App" },
-    }) as MobileProject & { ios: IosProject; android: AndroidProject };
-  }
-  async init() {
-    const project = this.project as MobileProject;
-    await this.project.load();
-    const hasAndroid = await FileSys.fileExists(`${this.app.cwdPath}/android/app/build.gradle`);
-    const hasIos = await FileSys.fileExists(`${this.app.cwdPath}/ios/App/App.xcodeproj/project.pbxproj`);
-    if (!project.android && !hasAndroid) {
-      await this.app.spawn("npx", ["cap", "add", "android"]);
-      await this.project.load();
-    }
-    if (!project.ios && !hasIos) {
-      await this.app.spawn("npx", ["cap", "add", "ios"]);
-      await this.project.load();
-    }
-    return this;
-  }
-  async save() {
-    await this.project.commit();
-  }
-  async #prepareIos() {
-    const isAdded = await FileSys.fileExists(`${this.app.cwdPath}/ios/App/App.xcodeproj/project.pbxproj`);
-    if (!isAdded) {
-      await this.app.spawn("npx", ["cap", "add", "ios"]);
-      await this.app.spawn("npx", ["@capacitor/assets", "generate"]);
-    } else this.app.verbose(`iOS already added, skip adding process`);
-    this.app.verbose(`syncing iOS`);
-    await this.app.spawn("npx", ["cap", "sync", "ios"]);
-    this.app.verbose(`sync completed.`);
-  }
-  async buildIos() {
-    await this.#prepareIos();
-    this.app.verbose(`build completed iOS.`);
-    return;
-  }
-  async syncIos() {
-    await this.app.spawn("npx", ["cap", "sync", "ios"]);
-  }
-  async openIos() {
-    await this.app.spawn("npx", ["cap", "open", "ios"]);
-  }
-  async runIos({ operation, appId, version = "0.0.1", buildNum = 1, host = "local" }: RunConfig) {
-    const defaultAppId = `com.${this.app.name}.app`;
-    await this.#prepareIos();
-    this.project.ios.setBundleId("App", "Debug", appId ?? defaultAppId);
-    this.project.ios.setBundleId("App", "Release", appId ?? defaultAppId);
-    await this.project.ios.setVersion("App", "Debug", version);
-    await this.project.ios.setVersion("App", "Release", version);
-    await this.project.ios.setBuild("App", "Debug", buildNum);
-    await this.project.ios.setBuild("App", "Release", buildNum);
-    await this.project.commit();
-    await this.app.spawn(
-      "npx",
-      ["cross-env", `APP_OPERATION_MODE=${operation}`, `BUN_PUBLIC_ENV=${host}`, "npx", "cap", "run", "ios"],
-      {
-        stdio: "inherit",
-      },
-    );
-
-    // this.project.ios.incrementBuild("App", "Debug");
-    // this.project.ios.incrementBuild("App", "Release");
-  }
-
-  async #prepareAndroid() {
-    const isAdded = await Bun.file(`${this.app.cwdPath}/android/app/build.gradle`).exists();
-    if (!isAdded) {
-      await this.app.spawn("npx", ["cap", "add", "android"]);
-    } else this.app.verbose(`Android already added, skip adding process`);
-    await this.app.spawn("npx", ["@capacitor/assets", "generate"]);
-    await this.app.spawn("npx", ["cap", "sync", "android"]);
-  }
-
-  async #updateAndroidBuildTypes() {
-    //keystore 기본 설정 및 debug, release 설정
-
-    const appGradle = await FileEditor.create(`${this.app.cwdPath}/android/app/build.gradle`);
-    const buildTypesBlock = `
-      debug {
-        applicationIdSuffix ".debug"
-        versionNameSuffix "-DEBUG"
-        debuggable true
-        minifyEnabled false
-      }
-    `;
-    const singinConfigBlock = `
-     signingConfigs {
-        debug {
-            storeFile file('debug.keystore')
-            storePassword 'android'
-            keyAlias 'androiddebugkey'
-            keyPassword 'android'
-        }
-        release {
-            if (project.hasProperty('MYAPP_RELEASE_STORE_FILE')) {
-                storeFile file(MYAPP_RELEASE_STORE_FILE)
-                storePassword MYAPP_RELEASE_STORE_PASSWORD
-                keyAlias MYAPP_RELEASE_KEY_ALIAS
-                keyPassword MYAPP_RELEASE_KEY_PASSWORD
-            }
-        }
-    }
-        `;
-    if (appGradle.find("signingConfigs {") === -1) {
-      appGradle.insertBefore("buildTypes {", singinConfigBlock);
-    }
-    if (appGradle.find(`applicationIdSuffix ".debug"`) === -1) {
-      appGradle.insertAfter("buildTypes {", buildTypesBlock);
-    }
-    await appGradle.save();
-  }
-  async buildAndroid(assembleType: "apk" | "aab") {
-    await this.#prepareAndroid();
-    await this.#updateAndroidBuildTypes();
-    //윈도우는 gradlew.bat 사용
-    const isWindows = process.platform === "win32";
-    const gradleCommand = isWindows ? "gradlew.bat" : "./gradlew";
-
-    await this.app.spawn(gradleCommand, [assembleType === "apk" ? "assembleRelease" : "bundleRelease"], {
-      stdio: "inherit",
-      cwd: `${this.app.cwdPath}/android`,
-    });
-  }
-  async openAndroid() {
-    await this.app.spawn("npx", ["cap", "open", "android"]);
-  }
-  async syncAndroid() {
-    await this.#prepareAndroid();
-    this.app.log(`Sync Android Completed.`);
-  }
-  async runAndroid({ operation, appName, appId, version = "0.0.1", buildNum = 1, host = "local" }: RunConfig) {
-    const defaultAppId = `com.${this.app.name}.app`;
-    const defaultAppName = this.app.name;
-    await this.project.android.setVersionName(version);
-    await this.project.android.setPackageName(appId ?? defaultAppId);
-    await this.project.android.setVersionCode(buildNum);
-    const versionName = await this.project.android.getVersionName();
-    const versionCode = await this.project.android.getVersionCode();
-    await this.project.android.setAppName(appName ?? defaultAppName);
-    await this.project.commit();
-    await this.#prepareAndroid();
-
-    this.app.logger.info(`Running Android in ${operation} mode on ${host} host`);
-    await this.app.spawn(
-      "npx",
-      ["cross-env", `BUN_PUBLIC_ENV=${host}`, `APP_OPERATION_MODE=${operation}`, "npx", "cap", "run", "android"],
-      {
-        stdio: "inherit",
-      },
-    );
-  }
-
-  //? 릴리즈시 buildNum +1 version 파라미터 받아서 업데이트
-  async updateAndroidVersion(version: string, buildNum: number) {
-    //TODO: 테스트 확인 필요
-    await this.project.android.setVersionName(version);
-    await this.project.android.setVersionCode(buildNum);
-    const versionName = await this.project.android.getVersionName();
-    const versionCode = await this.project.android.getVersionCode();
-    await this.project.commit();
-  }
-  async releaseIos() {
-    //TODO: 작업 필요
-    const isAdded = await Bun.file(`${this.app.cwdPath}/ios/App/App.xcodeproj/project.pbxproj`).exists();
-    if (!isAdded) {
-      await this.app.spawn("npx cap add ios");
-      await this.app.spawn("npx @capacitor/assets generate");
-    } else this.app.log(`iOS already added, skip adding process`);
-    await this.app.spawn("cross-env", ["APP_OPERATION_MODE=release", "npx", "cap", "sync", "ios"]);
-  }
-  async releaseAndroid() {
-    //TODO: 작업 필요
-    const isAdded = await Bun.file(`${this.app.cwdPath}/android/app/build.gradle`).exists();
-    if (!isAdded) {
-      await this.app.spawn("npx cap add android");
-      await this.app.spawn("npx @capacitor/assets generate");
-    } else this.app.log(`android already added, skip adding process`);
-    await this.app.spawn("cross-env", ["APP_OPERATION_MODE=release", "npx", "cap", "sync", "android"]);
-  }
-  async addCamera() {
-    await this.#setPermissionInIos({
-      cameraUsageDescription: "$(PRODUCT_NAME) requires access to the camera to take photos.",
-      photoAddUsageDescription: "$(PRODUCT_NAME) requires access to the photo library to take photos.",
-      photoUsageDescription: "$(PRODUCT_NAME) requires access to the photo library to take photos.",
-    });
-    this.#setPermissionsInAndroid(["READ_MEDIA_IMAGES", "READ_EXTERNAL_STORAGE", "WRITE_EXTERNAL_STORAGE"]);
-  }
-  async addContact() {
-    await this.#setPermissionInIos({
-      contactsUsageDescription: "$(PRODUCT_NAME) requires access to the contacts to add new contacts.",
-    });
-    this.#setPermissionsInAndroid(["READ_CONTACTS", "WRITE_CONTACTS"]);
-  }
-  async addLocation() {
-    await this.#setPermissionInIos({
-      locationAlwaysUsageDescription: "$(PRODUCT_NAME) requires access to the location to get the user's location.",
-      locationWhenInUseUsageDescription: "$(PRODUCT_NAME) requires access to the location to get the user's location.",
-    });
-    this.#setPermissionsInAndroid(["ACCESS_COARSE_LOCATION", "ACCESS_FINE_LOCATION"]);
-    this.#setFeaturesInAndroid(["android.hardware.location.gps"]);
-  }
-  async #setPermissionInIos(permissions: { [key: string]: string }) {
-    const updateNs = Object.fromEntries(
-      Object.entries(permissions).map(([key, value]) => [`NS${capitalize(key)}`, value]),
-    );
-    await Promise.all([
-      this.project.ios.updateInfoPlist(this.iosTargetName, "Debug", updateNs),
-      this.project.ios.updateInfoPlist(this.iosTargetName, "Release", updateNs),
-    ]);
-  }
-  #setFeaturesInAndroid(features: string[]) {
-    for (const feature of features) {
-      if (this.#hasFeatureInAndroid(feature)) {
-        this.app.logger.info(`${feature} already exists in android`);
-        return this;
-      }
-      this.app.logger.info(`Adding ${feature} to android`);
-      this.project.android
-        .getAndroidManifest()
-        .injectFragment("manifest", `<uses-feature android:name="${feature}" />`);
-    }
-    return this;
-  }
-  #getFeaturesInAndroid() {
-    const androidManifest = this.project.android.getAndroidManifest();
-    const element = androidManifest.getDocumentElement();
-    if (!element) throw new Error("manifest not found");
-    const usesFeature = element.getElementsByTagName("uses-feature");
-    return Array.from(usesFeature).map((feature) => feature.getAttribute("android:name"));
-  }
-  #hasFeatureInAndroid(feature: string) {
-    return this.#getFeaturesInAndroid().includes(feature);
-  }
-
-  #setPermissionsInAndroid(permissions: string[]) {
-    for (const permission of permissions) {
-      if (this.#hasPermissionInAndroid(permission)) {
-        this.app.logger.info(`${permission} already exists in android`);
-        return this;
-      }
-      this.app.logger.info(`Adding ${permission} to android`);
-      this.project.android
-        .getAndroidManifest()
-        .injectFragment("manifest", `<uses-permission android:name="android.permission.${permission}" />`);
-    }
-    return this;
-  }
-  #getPermissionsInAndroid() {
-    const androidManifest = this.project.android.getAndroidManifest();
-    const element = androidManifest.getDocumentElement();
-    if (!element) throw new Error("manifest not found");
-    const usesPermission = element.getElementsByTagName("uses-permission");
-    return Array.from(usesPermission).map((permission) => permission.getAttribute("android:name"));
-  }
-  #hasPermissionInAndroid(permission: string) {
-    return this.#getPermissionsInAndroid().includes(permission);
-  }
-}

package/storeScanner.ts

@@ -1,173 +0,0 @@
-import path from "node:path";
-import ts from "typescript";
-import type { QualityWarning, SourceFileInfo } from "./qualityScanner";
-
-interface CustomAction {
-  name: string;
-  line: number;
-  /** The endpoints this action calls as `fetch.<name>`. Empty means it never leaves the client. */
-  fetched: string[];
-}
-
-/**
- * Checks that a store action an agent can reach says what it does, in the one place this codebase lets it.
- *
- * A store is the surface an in-page agent drives — it reads state through `st.use.*` and acts through `st.do.*` —
- * and an action's name and argument types are the only other thing it sees. Unlike a signal, a store has no
- * builder metadata and no room for prose: the house rules ban JSDoc, and every string a person reads goes through
- * `l()`. So the dictionary's `.store()` stage is the only legal channel for the sentence, and this is the check
- * that it exists where it is actually needed.
- *
- * Three kinds of action are deliberately quiet, because a warning nobody should act on teaches people to ignore
- * the rest:
- *
- *  - **Generated actions** (`createX`, `setFieldOnX`, `initXInY`, …) are not in the file at all. Their wording is
- *    derived from the model's own labels, so there is nothing for an author to write.
- *  - **An action that calls no `fetch.*`** stays on the client and is not published, so its description would be
- *    read by nobody.
- *  - **An action named after the endpoint it calls** already reads as that endpoint's `.desc()`. That is most of
- *    them, and not by accident — the naming rule is that `st.do.X` reads the same as `fetch.X`.
- *
- * What is left is the case where inheriting would be *wrong* rather than merely absent: nine `getSummaryListIn*`
- * actions that all call one `summaryListInPeriod`, where the difference between them is the whole point of having
- * nine; or `logout` over `signoutUser`, where the store name is the verb a user would say and the endpoint name is
- * the verb the API has. Those are the ones a person has to write.
- *
- * It reads source, so an action that reaches its endpoint through anything but a literal `fetch.<name>` — a
- * destructured `fetch`, a helper, a computed key — reads as calling none and stays quiet. Right for a warning that
- * must not fire on what it merely failed to resolve.
- */
-export class StoreScanner {
-  scan(sourceFiles: SourceFileInfo[]): QualityWarning[] {
-    const dictionaries = new Map(
-      sourceFiles
-        .filter((sourceFile) => sourceFile.file.endsWith(".dictionary.ts"))
-        .map((sourceFile) => [path.dirname(sourceFile.file), sourceFile]),
-    );
-    return sourceFiles
-      .filter((sourceFile) => sourceFile.file.endsWith(".store.ts"))
-      .flatMap((sourceFile) => this.#scanStore(sourceFile, dictionaries.get(path.dirname(sourceFile.file))));
-  }
-
-  #scanStore(store: SourceFileInfo, dictionary: SourceFileInfo | undefined): QualityWarning[] {
-    const actions = StoreScanner.#customActions(store);
-    if (!actions.length) return [];
-    const described = dictionary ? StoreScanner.#describedEntries(dictionary) : new Map<string, Set<string>>();
-    return actions
-      .filter(({ name, fetched }) => fetched.length && !fetched.includes(name))
-      .filter(({ name }) => !described.get("store")?.has(name) && !described.get("endpoint")?.has(name))
-      .map(({ name, line, fetched }) => ({
-        rule: "akan.agent.missing-store-description",
-        scope: "agent" as const,
-        severity: "warning" as const,
-        file: store.file,
-        line,
-        message: `Store action "${name}" calls ${fetched.map((key) => `${key}()`).join(", ")} under a different name and has no dictionary .store() entry, so an agent reading it has the name and nothing else.`,
-      }));
-  }
-
-  /** Methods written in the store class body. Generated actions never appear here, which is why they are exempt. */
-  static #customActions(store: SourceFileInfo): CustomAction[] {
-    const actions: CustomAction[] = [];
-    const visit = (node: ts.Node) => {
-      if (ts.isClassDeclaration(node) && StoreScanner.#extendsStore(node)) {
-        for (const member of node.members) {
-          // A getter computes rather than dispatches, and a static helper is not on `st.do` at all.
-          if (!ts.isMethodDeclaration(member)) continue;
-          if (member.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.StaticKeyword)) continue;
-          const name = StoreScanner.#memberName(member);
-          if (!name) continue;
-          const line = store.sourceFile.getLineAndCharacterOfPosition(member.getStart(store.sourceFile)).line + 1;
-          actions.push({ name, line, fetched: StoreScanner.#fetchedEndpoints(member) });
-        }
-      }
-      ts.forEachChild(node, visit);
-    };
-    visit(store.sourceFile);
-    return actions;
-  }
-
-  static #extendsStore(node: ts.ClassDeclaration) {
-    return !!node.heritageClauses?.some((clause) =>
-      clause.types.some((type) => ts.isCallExpression(type.expression) && StoreScanner.#isStoreCall(type.expression)),
-    );
-  }
-
-  static #isStoreCall(expression: ts.CallExpression) {
-    return ts.isIdentifier(expression.expression) && expression.expression.text === "store";
-  }
-
-  /** The `fetch.<name>` calls inside one action, which is what says whether it is reachable past the client. */
-  static #fetchedEndpoints(member: ts.MethodDeclaration): string[] {
-    const fetched = new Set<string>();
-    const visit = (node: ts.Node) => {
-      if (
-        ts.isCallExpression(node) &&
-        ts.isPropertyAccessExpression(node.expression) &&
-        ts.isIdentifier(node.expression.expression) &&
-        node.expression.expression.text === "fetch"
-      )
-        fetched.add(node.expression.name.text);
-      ts.forEachChild(node, visit);
-    };
-    visit(member);
-    return [...fetched];
-  }
-
-  /** Entry names that carry a `.desc()`, per dictionary stage. */
-  static #describedEntries(dictionary: SourceFileInfo): Map<string, Set<string>> {
-    const described = new Map<string, Set<string>>();
-    const visit = (node: ts.Node) => {
-      const stage = StoreScanner.#dictionaryStage(node);
-      if (stage) {
-        for (const [name, chain] of StoreScanner.#stageEntries(node as ts.CallExpression)) {
-          if (!chain.has("desc")) continue;
-          const names = described.get(stage) ?? new Set<string>();
-          names.add(name);
-          described.set(stage, names);
-        }
-      }
-      ts.forEachChild(node, visit);
-    };
-    visit(dictionary.sourceFile);
-    return described;
-  }
-
-  static #dictionaryStage(node: ts.Node) {
-    if (!ts.isCallExpression(node) || !ts.isPropertyAccessExpression(node.expression)) return null;
-    const stage = node.expression.name.text;
-    return stage === "store" || stage === "endpoint" ? stage : null;
-  }
-
-  static #stageEntries(stage: ts.CallExpression): Array<[string, Set<string>]> {
-    const callback = stage.arguments[0];
-    if (!callback || !ts.isArrowFunction(callback)) return [];
-    const body = ts.isParenthesizedExpression(callback.body) ? callback.body.expression : callback.body;
-    if (!ts.isObjectLiteralExpression(body)) return [];
-    return body.properties.flatMap((property) => {
-      if (!ts.isPropertyAssignment(property)) return [];
-      const name = StoreScanner.#memberName(property);
-      return name ? [[name, StoreScanner.#chainCalls(property.initializer)] as [string, Set<string>]] : [];
-    });
-  }
-
-  /**
-   * Only the calls on the entry's own chain. A nested `.arg((t) => ({ x: t([…]).desc([…]) }))` describes an
-   * argument, not the entry, so a subtree walk would read every entry as described.
-   */
-  static #chainCalls(expression: ts.Expression): Set<string> {
-    const calls = new Set<string>();
-    let current: ts.Node = expression;
-    while (ts.isCallExpression(current) || ts.isPropertyAccessExpression(current)) {
-      if (ts.isPropertyAccessExpression(current)) calls.add(current.name.text);
-      current = current.expression;
-    }
-    return calls;
-  }
-
-  static #memberName(member: ts.MethodDeclaration | ts.PropertyAssignment) {
-    const { name } = member;
-    if (!name || (!ts.isIdentifier(name) && !ts.isStringLiteral(name))) return null;
-    return name.text;
-  }
-}

package/streamAi.ts

@@ -1,45 +0,0 @@
-import { PromptTemplate } from "@langchain/core/prompts";
-import { RunnableSequence } from "@langchain/core/runnables";
-import { ChatOpenAI } from "@langchain/openai";
-
-interface StreamResponse {
-  content: string;
-  chunk?: string;
-}
-
-export const streamAi = async (
-  question: string,
-  callback: (chunk: string) => void = (chunk) => {
-    process.stdout.write(chunk);
-  },
-): Promise<StreamResponse> => {
-  const createStreamingModel = (apiKey = process.env.DEEPSEEK_API_KEY) => {
-    if (!apiKey) throw new Error(`process.env.DEEPSEEK_API_KEY is not set`);
-    return new ChatOpenAI({
-      modelName: "deepseek-reasoner",
-      temperature: 0.7,
-      streaming: true, // Enable streaming
-      configuration: { baseURL: "https://api.deepseek.com/v1", apiKey },
-    });
-  };
-  const createProcessingChain = () => {
-    return RunnableSequence.from([PromptTemplate.fromTemplate(`Answer concisely: {question}`), createStreamingModel()]);
-  };
-  try {
-    const chain = createProcessingChain();
-    const stream = await chain.stream({ question });
-
-    let fullResponse = "";
-    for await (const chunk of stream) {
-      const content = chunk.content;
-      if (typeof content === "string") {
-        fullResponse += content;
-        callback(content); // Send individual chunks to callback
-      }
-    }
-
-    return { content: fullResponse };
-  } catch (error) {
-    throw new Error("Failed to stream response");
-  }
-};