@anhlp/alp 0.0.1-beta.4 → 0.0.1-beta.6

package/packages/core/dist/hooks.d.ts

@@ -1,35 +0,0 @@
-/**
- * The hook definitions an agent uses (ALPD §45): those it names in agent.json and the
- * JSON files in its own hooks/ directory. `project` marks a hook that comes from the
- * project's .alp/, which runs only once the user trusts the workspace.
- * @param {import('./types.js').ResolvedAgent} agent
- * @returns {Promise<Array<{ name: string, path: string, project: boolean, event: string, command: string, blocking?: boolean, timeoutSec?: number, match?: { agent?: string, label?: string }, description?: string }>>}
- */
-export function loadHooks(agent: import("./types.js").ResolvedAgent): Promise<Array<{
-    name: string;
-    path: string;
-    project: boolean;
-    event: string;
-    command: string;
-    blocking?: boolean;
-    timeoutSec?: number;
-    match?: {
-        agent?: string;
-        label?: string;
-    };
-    description?: string;
-}>>;
-/**
- * Whether a hook applies: to its agent, if it names one, and to tasks with its label, if it names one.
- * @param {{ match?: { agent?: string, label?: string } }} hook
- * @param {{ agent: string, labels?: string[] }} context
- */
-export function hookMatches(hook: {
-    match?: {
-        agent?: string;
-        label?: string;
-    };
-}, { agent, labels }: {
-    agent: string;
-    labels?: string[];
-}): boolean;

package/packages/core/dist/hooks.js

@@ -1,30 +0,0 @@
-// packages/core/src/hooks.js
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import { AlpError } from "./errors.js";
-import { validateHook } from "./validation.js";
-async function loadHooks(agent) {
-  const project = path.join(agent.projectRoot, ".alp") + path.sep;
-  const hooks = [];
-  for (const { name, path: file } of agent.hooks) {
-    if (!file.endsWith(".json")) throw new AlpError("INVALID_HOOK", `${file}: a hook is a JSON definition, hooks/<name>.json, with an event and a command`);
-    let config;
-    try {
-      config = JSON.parse(await readFile(file, "utf8"));
-    } catch (cause) {
-      throw new AlpError("INVALID_HOOK", `${file}: ${cause.message}`, { cause });
-    }
-    validateHook(config, file);
-    hooks.push({ ...config, name: name.replace(/\.json$/, ""), path: file, project: file.startsWith(project) });
-  }
-  return hooks;
-}
-function hookMatches(hook, { agent, labels = [] }) {
-  if (hook.match?.agent && hook.match.agent !== agent) return false;
-  if (hook.match?.label && !labels.includes(hook.match.label)) return false;
-  return true;
-}
-export {
-  hookMatches,
-  loadHooks
-};

package/packages/core/dist/index.d.ts

@@ -1,31 +0,0 @@
-export * as adapter from "./adapter.js";
-export * as atomic from "./atomic.js";
-export * as backup from "./backup.js";
-export * as beads from "./beads.js";
-export * as delegation from "./delegation.js";
-export * as errors from "./errors.js";
-export * as formulas from "./formulas.js";
-export * as hook_run from "./hook-run.js";
-export * as hooks from "./hooks.js";
-export * as init from "./init.js";
-export * as library_edit from "./library-edit.js";
-export * as library from "./library.js";
-export * as log from "./log.js";
-export * as migrations from "./migrations.js";
-export * as models from "./models.js";
-export * as permissions from "./permissions.js";
-export * as profiles from "./profiles.js";
-export * as promptsafe from "./promptsafe.js";
-export * as providers from "./providers.js";
-export * as resolver from "./resolver.js";
-export * as state_schema from "./state-schema.js";
-export * as task_rows from "./task-rows.js";
-export * as tasks from "./tasks.js";
-export * as teams from "./teams.js";
-export * as trust from "./trust.js";
-export * as upgrade from "./upgrade.js";
-export * as user_settings from "./user-settings.js";
-export * as validation from "./validation.js";
-export * as verify from "./verify.js";
-export * as workflow from "./workflow.js";
-export * as user_worktree from "./user-worktree.js";

package/packages/core/dist/index.js

@@ -1,65 +0,0 @@
-// packages/core/src/index.js
-import * as adapter from "./adapter.js";
-import * as atomic from "./atomic.js";
-import * as backup from "./backup.js";
-import * as beads from "./beads.js";
-import * as delegation from "./delegation.js";
-import * as errors from "./errors.js";
-import * as formulas from "./formulas.js";
-import * as hook_run from "./hook-run.js";
-import * as hooks from "./hooks.js";
-import * as init from "./init.js";
-import * as library_edit from "./library-edit.js";
-import * as library from "./library.js";
-import * as log from "./log.js";
-import * as migrations from "./migrations.js";
-import * as models from "./models.js";
-import * as permissions from "./permissions.js";
-import * as profiles from "./profiles.js";
-import * as promptsafe from "./promptsafe.js";
-import * as providers from "./providers.js";
-import * as resolver from "./resolver.js";
-import * as state_schema from "./state-schema.js";
-import * as task_rows from "./task-rows.js";
-import * as tasks from "./tasks.js";
-import * as teams from "./teams.js";
-import * as trust from "./trust.js";
-import * as upgrade from "./upgrade.js";
-import * as user_settings from "./user-settings.js";
-import * as validation from "./validation.js";
-import * as verify from "./verify.js";
-import * as workflow from "./workflow.js";
-import * as user_worktree from "./user-worktree.js";
-export {
-  adapter,
-  atomic,
-  backup,
-  beads,
-  delegation,
-  errors,
-  formulas,
-  hook_run,
-  hooks,
-  init,
-  library,
-  library_edit,
-  log,
-  migrations,
-  models,
-  permissions,
-  profiles,
-  promptsafe,
-  providers,
-  resolver,
-  state_schema,
-  task_rows,
-  tasks,
-  teams,
-  trust,
-  upgrade,
-  user_settings,
-  user_worktree,
-  validation,
-  verify,
-  workflow
-};

package/packages/core/dist/init.d.ts

@@ -1,30 +0,0 @@
-/**
- * Fill missing scaffold files without replacing existing user content: ALP.md and
- * .alp/settings.json. Agents, skills, MCP servers and hooks come from ALP's built-ins
- * and the user's library (ALPD §41); a project adds its own under .alp/ only to
- * override them.
- * @param {string} projectRoot
- * @param {{ templateRoot?: URL, templates?: Record<string, string>, library?: string, syncProfiles?: boolean, onlyManagedProfiles?: boolean, teamIds?: string[] }} [options]
- */
-export function initProject(projectRoot: string, { templateRoot, templates, library, syncProfiles, onlyManagedProfiles, teamIds }?: {
-    templateRoot?: URL;
-    templates?: Record<string, string>;
-    library?: string;
-    syncProfiles?: boolean;
-    onlyManagedProfiles?: boolean;
-    teamIds?: string[];
-}): Promise<{
-    updated?: string[] | undefined;
-    created: string[];
-    preserved: string[];
-}>;
-/** Refresh an existing project's settings only; a template Save must not scaffold unrelated folders.
- * @param {string} projectRoot
- * @param {{ library?: string, templates?: Record<string, string>, teamIds?: string[], replaceModels?: boolean }} [options]
- */
-export function syncProjectSettings(projectRoot: string, { library, templates, teamIds, replaceModels }?: {
-    library?: string;
-    templates?: Record<string, string>;
-    teamIds?: string[];
-    replaceModels?: boolean;
-}): Promise<boolean>;

package/packages/core/dist/init.js

@@ -1,89 +0,0 @@
-// packages/core/src/init.js
-import { shippedTemplateRoot } from "./template-path.js";
-import { mkdir, writeFile, lstat, readFile, rename, rm } from "node:fs/promises";
-import path from "node:path";
-import { randomUUID } from "node:crypto";
-import { projectProfiles, profileDefaults, syncTemplateProfiles } from "./profiles.js";
-import { validateSettings } from "./validation.js";
-import { INIT_TEAM } from "./workflow.js";
-async function initProject(projectRoot, { templateRoot, templates, library, syncProfiles = true, onlyManagedProfiles = false, teamIds } = {}) {
-  const root = path.resolve(projectRoot);
-  const sourceRoot = () => templateRoot ?? shippedTemplateRoot();
-  const template = (name) => templates ? Promise.resolve(templates[name]) : readFile(new URL(name, sourceRoot()), "utf8");
-  const scaffold = path.join(root, ".alp");
-  const existing = await lstat(scaffold).catch((error) => {
-    if (error.code !== "ENOENT") throw error;
-  });
-  if (existing && !existing.isDirectory()) throw new Error(`Expected a directory: ${scaffold}`);
-  const team = await projectProfiles({ root, templates, library, teamIds });
-  const files = {
-    "ALP.md": await template("ALP.md"),
-    ".alp/settings.json": JSON.stringify({ defaultAgent: "main", workflow: { mode: INIT_TEAM }, team, templateDefaults: profileDefaults(team) }, null, 2) + "\n"
-  };
-  const directories = [".alp"];
-  const created = [];
-  const preserved = [];
-  const updated = [];
-  await mkdir(root, { recursive: true });
-  for (const directory of directories) {
-    const target = path.join(root, directory);
-    try {
-      await mkdir(target);
-    } catch (error) {
-      if (error.code !== "EEXIST") throw error;
-      if (!(await lstat(target)).isDirectory()) throw new Error(`Expected a directory: ${target}`);
-    }
-  }
-  for (const [name, content] of Object.entries(files)) {
-    const target = path.join(root, name);
-    try {
-      await writeFile(target, content, { flag: "wx" });
-      created.push(name);
-    } catch (error) {
-      if (error.code !== "EEXIST") throw error;
-      if (!(await lstat(target)).isFile()) throw new Error(`Expected a regular file: ${target}`);
-      preserved.push(name);
-      if (name === ".alp/settings.json" && syncProfiles) {
-        const before = await readFile(target, "utf8");
-        const settings = JSON.parse(before);
-        validateSettings(settings, target);
-        const next = !onlyManagedProfiles || settings.team || settings.profile || settings.templateDefaults ? await syncTemplateProfiles(settings, { root, library, templates, teamIds }) : settings;
-        validateSettings(next, target);
-        if (JSON.stringify(next) !== JSON.stringify(settings)) {
-          if (await readFile(target, "utf8") !== before) throw new Error(`File changed during initialization: ${target}`);
-          await writeFile(target, JSON.stringify(next, null, 2) + "\n");
-          updated.push(name);
-        }
-      }
-    }
-  }
-  return { created, preserved, ...updated.length ? { updated } : {} };
-}
-async function syncProjectSettings(projectRoot, { library, templates, teamIds, replaceModels = false } = {}) {
-  const root = path.resolve(projectRoot);
-  const file = path.join(root, ".alp/settings.json");
-  const info = await lstat(file).catch((error) => {
-    if (error.code !== "ENOENT") throw error;
-  });
-  if (!info) return false;
-  if (!info.isFile()) throw new Error(`Expected a regular file: ${file}`);
-  const before = await readFile(file, "utf8");
-  const settings = JSON.parse(before);
-  validateSettings(settings, file);
-  const next = await syncTemplateProfiles(settings, { root, library, templates, teamIds, replaceModels });
-  validateSettings(next, file);
-  if (JSON.stringify(settings) === JSON.stringify(next)) return false;
-  const temporary = `${file}.${randomUUID()}.tmp`;
-  try {
-    await writeFile(temporary, JSON.stringify(next, null, 2) + "\n", { flag: "wx", mode: info.mode });
-    if (await readFile(file, "utf8") !== before) throw new Error(`Settings changed while saving the template: ${file}`);
-    await rename(temporary, file);
-  } finally {
-    await rm(temporary, { force: true });
-  }
-  return true;
-}
-export {
-  initProject,
-  syncProjectSettings
-};

package/packages/core/dist/library-edit.d.ts

@@ -1,93 +0,0 @@
-/** Strict payload contract for opt-in project-data writes. Instructions carry prompt authority;
- * executable configuration and references to it have no place in this policy. */
-export function assertProjectDataContent(kind: any, content: any): void;
-/**
- * One entry: the version that applies (the project's, else the library's, else the
- * built-in), or one scope's version with `scope`. `revision` goes back with a save.
- * @param {'agents' | 'skills' | 'mcp' | 'hooks' | 'teams' | 'providers'} kind
- * @param {string} name
- * @param {{ root?: string, library?: string, templates?: Record<string, string>, scope?: 'library' | 'project' }} [options]
- * @returns {Promise<{ kind: 'agents' | 'skills' | 'mcp' | 'hooks' | 'teams' | 'providers', name: string, source: 'builtin' | 'library' | 'project', overrides?: 'builtin' | 'library' | 'project', content: Record<string, unknown>, revision: string | null, usedBy: string[] }>}
- */
-export function getEntry(kind: "agents" | "skills" | "mcp" | "hooks" | "teams" | "providers", name: string, { root, library, templates, scope }?: {
-    root?: string;
-    library?: string;
-    templates?: Record<string, string>;
-    scope?: "library" | "project";
-}): Promise<{
-    kind: "agents" | "skills" | "mcp" | "hooks" | "teams" | "providers";
-    name: string;
-    source: "builtin" | "library" | "project";
-    overrides?: "builtin" | "library" | "project";
-    content: Record<string, unknown>;
-    revision: string | null;
-    usedBy: string[];
-}>;
-/** The skills the library gives `agent`, as role-skills.json lists them. */
-export function givenSkills(library: any, agent: any): Promise<string[]>;
-/**
- * Sets the skills the library gives an agent (role-skills.json), so a built-in agent's
- * skills change without copying its instructions. Every skill must be in the library.
- * @returns {Promise<{ skills: string[] }>}
- */
-export function setGivenSkills(agent: any, skills: any, { library }?: {}): Promise<{
-    skills: string[];
-}>;
-/** Every entry of a kind with its source and users, as `alp <kind>` lists them. */
-export function listEntries(kind: any, { root, library, templates }?: {}): Promise<{
-    name: string;
-    source: "builtin" | "library" | "project";
-    path?: string;
-    overrides?: "builtin" | "library";
-    description?: string;
-    usedBy?: string[];
-}[] | {
-    usedBy: any[];
-    path?: string | undefined;
-    overrides?: "library" | "builtin" | undefined;
-    name: string;
-    source: "library" | "project" | "builtin";
-}[]>;
-/** Who refers to an entry: agents naming it, teams with it as a member, settings and role-skills.json. */
-export function usersOf(kind: any, name: any, { root, library, templates }?: {}): Promise<any[]>;
-/**
- * Creates or replaces an entry in a scope. `revision` is what getEntry returned for
- * that scope (null to create); a different current revision refuses the save.
- * @returns {Promise<{ revision: string | null }>}
- */
-export function saveEntry(kind: any, name: any, content: any, { scope, root, library, templates, revision, policy }?: {}): Promise<{
-    revision: string | null;
-}>;
-/**
- * Removes an entry from a scope. When nothing else of that name is left below it, an
- * entry others refer to stays, and the error lists them.
- * @returns {Promise<{ removed: boolean, now?: 'builtin' | 'library' }>}
- */
-export function deleteEntry(kind: any, name: any, { scope, root, library, templates, revision, policy }?: {}): Promise<{
-    removed: boolean;
-    now?: "builtin" | "library";
-}>;
-/** Copies the entry that applies under `from` to a new entry `to` in a scope; built-ins are copied this way. */
-export function duplicateEntry(kind: any, from: any, to: any, { scope, root, library, templates, policy }?: {}): Promise<{
-    revision: string | null;
-}>;
-/** Renames an entry within a scope; refused while others refer to it by its old name. */
-export function renameEntry(kind: any, from: any, to: any, { scope, root, library, templates, policy }?: {}): Promise<{
-    revision: string | null;
-}>;
-/**
- * Editing the library (ALPD §43): agents, skills, MCP servers, hooks and teams, in the
- * user's library (ALP_HOME) or as a project's override (.alp/). Built-ins are never
- * written; duplicate one, or save an entry of its name, to change it. Every save is
- * checked first and written file by file through a temporary file and a rename; a
- * revision taken when the entry was read refuses a save over someone else's change.
- *
- * An entry's content, by kind:
- *   agents  { instructions, config? }   AGENT.md and agent.json
- *   skills  { body }                    SKILL.md
- *   mcp     { server }                  mcp/<name>.json
- *   hooks   { hook }                    hooks/<name>.json
- *   teams   { team, houseRules? }       team.json and HOUSE_RULES.md
- *   providers { provider }              providers/<name>.json, in the library only (ALPD §46)
- */
-export const EDIT_KINDS: string[];