aimeat 1.40.1 → 2.0.0

package/dist/src/services/app-template-proposals.js

@@ -0,0 +1,114 @@
+/**
+ * @file app-template-proposals.ts
+ * @description Agent-proposed app templates — after building/publishing an app, an agent
+ *   records what generalizes so the owner's NEXT build starts from it (fork the source app or
+ *   scaffold from the reuse notes). Mirrors the skills-registry substrate 1:1: one manifest
+ *   memory record per proposal at `template.catalog.{id}.manifest` under the owner's GHII,
+ *   visibility `private` in v1 (sharing/selling later = a visibility flip, no migration).
+ *   The tier/packs/composes fields reuse the curated AppTemplate vocabulary so promotion into
+ *   src/data/app-templates.ts is a copy, not a mapping. Model attribution is MANDATORY and
+ *   indicative. Read by the appdev overview and the `templates` discovery source.
+ * @structure TemplateProposalManifest; proposeTemplate/listTemplateProposals/
+ *   getTemplateProposal/deleteTemplateProposal; templateProposalKey()
+ * @usage import { proposeTemplate, listTemplateProposals } from './app-template-proposals.js';
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — initial (AppDev KB Phase 6).
+ */
+import { parseGAII } from '../utils/gaii.js';
+const ID_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+export const templateProposalKey = (id) => `template.catalog.${id}.manifest`;
+export const TEMPLATE_PROPOSAL_KEY_RE = /^template\.catalog\.([a-z0-9]+(?:-[a-z0-9]+)*)\.manifest$/;
+function ownerGhiiOf(callerGaii, config) {
+    const parsed = parseGAII(callerGaii);
+    if (parsed?.owner)
+        return { owner: parsed.owner, ownerGhii: `${parsed.owner}@${config.nodeId}` };
+    if (callerGaii.includes('@') && !callerGaii.includes('#')) {
+        return { owner: callerGaii.split('@')[0], ownerGhii: callerGaii };
+    }
+    return null;
+}
+/** Upsert a proposal (same id replaces — proposals are meant to improve over time). */
+export async function proposeTemplate(storage, config, callerGaii, input) {
+    const who = ownerGhiiOf(callerGaii, config);
+    if (!who)
+        return { error: 'Could not resolve the caller to an owner' };
+    if (!ID_RE.test(input.id) || input.id.length > 64) {
+        return { error: 'Invalid template id — use kebab-case (a-z, 0-9, dashes), max 64 chars' };
+    }
+    // The derived-from app must exist and belong to THIS owner (a template proposal is a
+    // reflection on the owner's own build, not a claim over someone else's app).
+    if (input.derived_from.owner !== who.owner) {
+        return { error: 'derived_from.owner must be your own owner name' };
+    }
+    const sourceOwnerGhii = `${input.derived_from.owner}@${config.nodeId}`;
+    const app = await storage.getApp(sourceOwnerGhii, input.derived_from.filename);
+    if (!app)
+        return { error: `derived_from app not found: ${input.derived_from.owner}/${input.derived_from.filename}` };
+    const key = templateProposalKey(input.id);
+    const existing = await storage.getMemory(who.ownerGhii, key);
+    const existingValue = existing?.value;
+    const now = new Date().toISOString();
+    const manifest = {
+        id: input.id,
+        title: input.title,
+        description: input.description,
+        derivedFrom: {
+            owner: input.derived_from.owner,
+            filename: input.derived_from.filename,
+            version: app.versionNumber,
+            node: config.nodeId,
+        },
+        tier: input.tier,
+        tags: (input.tags ?? []).slice(0, 12),
+        reuseNotes: input.reuse_notes,
+        startMode: input.start_mode ?? 'either',
+        ...(input.start_mode_rationale ? { startModeRationale: input.start_mode_rationale } : {}),
+        model: input.model.trim().toLowerCase(),
+        ...(input.model_notes ? { modelNotes: input.model_notes } : {}),
+        // Proofs survive an upsert — they attach to the proposal id, not one wording of it.
+        ...(existingValue?.proofs ? { proofs: existingValue.proofs } : {}),
+        ...(input.packs ? { packs: input.packs } : {}),
+        ...(input.composes ? { composes: input.composes } : {}),
+        proposedBy: callerGaii,
+        createdAt: existingValue?.createdAt ?? now,
+        updatedAt: now,
+    };
+    await storage.setMemory({
+        key,
+        ownerGaii: who.ownerGhii,
+        value: manifest,
+        visibility: existing?.visibility ?? 'private',
+        tags: ['template', 'template-proposal', `model:${manifest.model}`, `tier:${manifest.tier}`],
+        ttlHours: null,
+        version: (existing?.version ?? 0) + 1,
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
+    });
+    return { manifest, updated: !!existing };
+}
+export async function listTemplateProposals(storage, config, callerGaii) {
+    const who = ownerGhiiOf(callerGaii, config);
+    if (!who)
+        return [];
+    const records = await storage.listMemory(who.ownerGhii, { prefix: 'template.catalog.', tags: ['template'] });
+    return records
+        .filter(r => TEMPLATE_PROPOSAL_KEY_RE.test(r.key))
+        .map(r => r.value)
+        .filter(Boolean);
+}
+export async function getTemplateProposal(storage, config, callerGaii, id) {
+    const who = ownerGhiiOf(callerGaii, config);
+    if (!who || !ID_RE.test(id))
+        return null;
+    const record = await storage.getMemory(who.ownerGhii, templateProposalKey(id));
+    if (!record)
+        return null;
+    return { record, manifest: record.value };
+}
+export async function deleteTemplateProposal(storage, config, callerGaii, id) {
+    const who = ownerGhiiOf(callerGaii, config);
+    if (!who || !ID_RE.test(id))
+        return false;
+    return storage.deleteMemory(who.ownerGhii, templateProposalKey(id));
+}
+//# sourceMappingURL=app-template-proposals.js.map

package/dist/src/services/app-template-proposals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-template-proposals.js","sourceRoot":"","sources":["../../../src/services/app-template-proposals.ts"],"names":[],"mappings":"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"}

package/dist/src/services/appdev-flow-constants.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @file appdev-flow-constants.ts
+ * @description Shared vocabulary of the research-first appdev flow — imported by the build-app
+ *   prompt, the appdev-flow prompt, and the appdev handbook so the step names, the skip phrase,
+ *   and the tool list can never drift between surfaces. The flow itself: RESEARCH (what exists)
+ *   → FRAME (tier, packs, iam) → PROPOSE (to the user) → BUILD → FINISH (face, skill, template,
+ *   learnings). The user can always skip straight to building.
+ * @structure FLOW_* string constants + buildResearchStep()/buildFinishChecklist() fragments
+ * @usage import { FLOW_SKIP_PHRASE, buildResearchStep } from './appdev-flow-constants.js';
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — initial (AppDev KB Phase 7).
+ */
+/** The five flow phases, in order — the promise an MCP connection makes. */
+export declare const FLOW_PHASES: "research \u2192 frame \u2192 propose \u2192 build \u2192 finish";
+/** When the user says anything like this, skip research/framing and build directly. */
+export declare const FLOW_SKIP_PHRASE: "just build it the usual way";
+/** Canonical tool names of the flow (single source for every prompt surface). */
+export declare const FLOW_TOOLS: {
+    readonly skill: "node:aimeat-app-builder";
+    readonly skillGet: "aimeat_skill_get";
+    readonly overview: "aimeat_appdev_overview";
+    readonly pitfallList: "aimeat_appdev_pitfall_list";
+    readonly pitfallReport: "aimeat_appdev_pitfall_report";
+    readonly templatePropose: "aimeat_app_template_propose";
+    readonly templateList: "aimeat_app_template_list";
+    readonly appList: "aimeat_app_list";
+    readonly appFork: "aimeat_app_fork";
+};
+/** The Step 0 research instruction (MCP agents; humans in a chat skip it naturally). */
+export declare function buildResearchStep(): string;
+/** The finish checklist appended to the MCP section of the build prompt. */
+export declare function buildFinishChecklist(): string;
+//# sourceMappingURL=appdev-flow-constants.d.ts.map

package/dist/src/services/appdev-flow-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appdev-flow-constants.d.ts","sourceRoot":"","sources":["../../../src/services/appdev-flow-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,WAAW,EAAG,iEAAsD,CAAC;AAElF,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,EAAG,6BAAsC,CAAC;AAEvE,iFAAiF;AACjF,eAAO,MAAM,UAAU;;;;;;;;;;CAUb,CAAC;AAEX,wFAAwF;AACxF,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/src/services/appdev-flow-constants.js

@@ -0,0 +1,43 @@
+/**
+ * @file appdev-flow-constants.ts
+ * @description Shared vocabulary of the research-first appdev flow — imported by the build-app
+ *   prompt, the appdev-flow prompt, and the appdev handbook so the step names, the skip phrase,
+ *   and the tool list can never drift between surfaces. The flow itself: RESEARCH (what exists)
+ *   → FRAME (tier, packs, iam) → PROPOSE (to the user) → BUILD → FINISH (face, skill, template,
+ *   learnings). The user can always skip straight to building.
+ * @structure FLOW_* string constants + buildResearchStep()/buildFinishChecklist() fragments
+ * @usage import { FLOW_SKIP_PHRASE, buildResearchStep } from './appdev-flow-constants.js';
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — initial (AppDev KB Phase 7).
+ */
+/** The five flow phases, in order — the promise an MCP connection makes. */
+export const FLOW_PHASES = 'research → frame → propose → build → finish';
+/** When the user says anything like this, skip research/framing and build directly. */
+export const FLOW_SKIP_PHRASE = 'just build it the usual way';
+/** Canonical tool names of the flow (single source for every prompt surface). */
+export const FLOW_TOOLS = {
+    skill: 'node:aimeat-app-builder',
+    skillGet: 'aimeat_skill_get',
+    overview: 'aimeat_appdev_overview',
+    pitfallList: 'aimeat_appdev_pitfall_list',
+    pitfallReport: 'aimeat_appdev_pitfall_report',
+    templatePropose: 'aimeat_app_template_propose',
+    templateList: 'aimeat_app_template_list',
+    appList: 'aimeat_app_list',
+    appFork: 'aimeat_app_fork',
+};
+/** The Step 0 research instruction (MCP agents; humans in a chat skip it naturally). */
+export function buildResearchStep() {
+    let s = '## Step 0 — Research first (agents with AIMEAT MCP tools)\n';
+    s += `If you have \`aimeat_*\` MCP tools, follow the ${FLOW_PHASES} flow — it is the promise an MCP connection makes: a better result than building cold.\n`;
+    s += `1. RESEARCH: load \`${FLOW_TOOLS.skill}\` (\`${FLOW_TOOLS.skillGet}\`), then call \`${FLOW_TOOLS.overview}\` (pass your OWN model id — self-identify from your own configuration, never ask the user) — the owner's existing apps and template proposals are usually the fastest correct starting point; read the pitfalls for the areas you will touch.\n`;
+    s += '2. FRAME: pick the tier (decision tree in Step 2), the capability packs, and whether the app needs its OWN users (aimeat-iam) — decide this NOW, not after the data model exists.\n';
+    s += '3. PROPOSE the frame to the user in 3-5 lines (tier, packs, start point: fork/template/scratch, iam yes/no) and adjust to their answer.\n';
+    s += `SKIP CLAUSE: if the user says "${FLOW_SKIP_PHRASE}" (or equivalent), skip Steps 0-1 and build directly — the flow is a default, never a gate. Without MCP tools, go straight to Step 1.\n\n`;
+    return s;
+}
+/** The finish checklist appended to the MCP section of the build prompt. */
+export function buildFinishChecklist() {
+    return `FINISH (after a successful publish — the publish response's next_steps shows what is missing): (1) publish the app's agent face + bind a skill (metadata.binding \`app:{owner}/{filename}\`) so the app is agent-facing by default; (2) if anything generalizes, record a template with \`${FLOW_TOOLS.templatePropose}\` (your own model id required — self-identify, never ask the user); (3) report what bit you with \`${FLOW_TOOLS.pitfallReport}\` (model required) — the next build starts smarter than this one.\n`;
+}
+//# sourceMappingURL=appdev-flow-constants.js.map

package/dist/src/services/appdev-flow-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appdev-flow-constants.js","sourceRoot":"","sources":["../../../src/services/appdev-flow-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,6CAAsD,CAAC;AAElF,uFAAuF;AACvF,MAAM,CAAC,MAAM,gBAAgB,GAAG,6BAAsC,CAAC;AAEvE,iFAAiF;AACjF,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,KAAK,EAAE,yBAAyB;IAChC,QAAQ,EAAE,kBAAkB;IAC5B,QAAQ,EAAE,wBAAwB;IAClC,WAAW,EAAE,4BAA4B;IACzC,aAAa,EAAE,8BAA8B;IAC7C,eAAe,EAAE,6BAA6B;IAC9C,YAAY,EAAE,0BAA0B;IACxC,OAAO,EAAE,iBAAiB;IAC1B,OAAO,EAAE,iBAAiB;CACpB,CAAC;AAEX,wFAAwF;AACxF,MAAM,UAAU,iBAAiB;IAC7B,IAAI,CAAC,GAAG,6DAA6D,CAAC;IACtE,CAAC,IAAI,kDAAkD,WAAW,0FAA0F,CAAC;IAC7J,CAAC,IAAI,uBAAuB,UAAU,CAAC,KAAK,SAAS,UAAU,CAAC,QAAQ,oBAAoB,UAAU,CAAC,QAAQ,kPAAkP,CAAC;IAClW,CAAC,IAAI,qLAAqL,CAAC;IAC3L,CAAC,IAAI,2IAA2I,CAAC;IACjJ,CAAC,IAAI,kCAAkC,gBAAgB,2IAA2I,CAAC;IACnM,OAAO,CAAC,CAAC;AACb,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB;IAChC,OAAO,6RAA6R,UAAU,CAAC,eAAe,uGAAuG,UAAU,CAAC,aAAa,sEAAsE,CAAC;AACxgB,CAAC"}

package/dist/src/services/appdev-flow-prompt.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @file appdev-flow-prompt.ts
+ * @description The paste-able "research-first" flow prompt served at GET /v1/prompts/appdev-flow —
+ *   what a user gives Claude Code / OpenHands / any MCP-connected coding agent to make it build
+ *   AIMEAT apps the accelerated way (research → frame → propose → build → finish) instead of
+ *   coding cold. This is the user-facing promise of an MCP connection; the flow vocabulary comes
+ *   from appdev-flow-constants.ts so it can never drift from the build prompt or the handbook.
+ * @structure buildAppdevFlowPrompt(config) → string
+ * @usage import { buildAppdevFlowPrompt } from '../services/appdev-flow-prompt.js';
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — initial (AppDev KB Phase 7).
+ */
+import type { AimeatConfig } from '../config.js';
+export declare function buildAppdevFlowPrompt(config: AimeatConfig): string;
+//# sourceMappingURL=appdev-flow-prompt.d.ts.map

package/dist/src/services/appdev-flow-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appdev-flow-prompt.d.ts","sourceRoot":"","sources":["../../../src/services/appdev-flow-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAyBlE"}

package/dist/src/services/appdev-flow-prompt.js

@@ -0,0 +1,40 @@
+/**
+ * @file appdev-flow-prompt.ts
+ * @description The paste-able "research-first" flow prompt served at GET /v1/prompts/appdev-flow —
+ *   what a user gives Claude Code / OpenHands / any MCP-connected coding agent to make it build
+ *   AIMEAT apps the accelerated way (research → frame → propose → build → finish) instead of
+ *   coding cold. This is the user-facing promise of an MCP connection; the flow vocabulary comes
+ *   from appdev-flow-constants.ts so it can never drift from the build prompt or the handbook.
+ * @structure buildAppdevFlowPrompt(config) → string
+ * @usage import { buildAppdevFlowPrompt } from '../services/appdev-flow-prompt.js';
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — initial (AppDev KB Phase 7).
+ */
+import { FLOW_PHASES, FLOW_SKIP_PHRASE, FLOW_TOOLS, buildFinishChecklist } from './appdev-flow-constants.js';
+export function buildAppdevFlowPrompt(config) {
+    const nodeUrl = config.baseUrl.replace(/\/+$/, '');
+    let p = '';
+    p += '# AIMEAT app development — the research-first flow\n\n';
+    p += 'You are an agentic coder connected to an AIMEAT node over MCP (the `aimeat_*` tools). ';
+    p += `Whenever I ask you to build, improve, or publish an app on AIMEAT, follow this flow: **${FLOW_PHASES}**. `;
+    p += 'The MCP connection is what makes this possible — use it to start from what already exists instead of building cold.\n\n';
+    p += '## 0. Self-identify\n';
+    p += 'Every model field in this flow is YOUR OWN model id (e.g. claude-fable-5, kimi-k2.7-code) — you know which model you are running as; take it from your own system configuration. NEVER ask the user for it, and never invent someone else\'s. It is indicative attribution, so your best self-knowledge is enough. The node URL is wherever your aimeat_* tools are connected — you never need the user to supply it either.\n\n';
+    p += '## 1. Research (before any code)\n';
+    p += `- Load the paved-path skill: \`${FLOW_TOOLS.skillGet}\` ref \`${FLOW_TOOLS.skill}\`.\n`;
+    p += `- Get the big picture in ONE call: \`${FLOW_TOOLS.overview}\` (pass your own model id). It returns my existing apps and template proposals (often the fastest correct starting point — fork or copy patterns), library packs with per-model proofs, T1/T2/T3 templates, and the pitfalls (curated + learned) for the areas you will touch.\n`;
+    p += `- Fetch the canonical build spec and treat it as law: \`GET ${nodeUrl}/v1/prompts/build-app\` — it always wins on any conflict.\n\n`;
+    p += '## 2. Frame\n';
+    p += 'Pick the tier (T1 pure client / T2 +cortex / T3 +extension), the capability packs, the starting point (fork a prior app / a template proposal / a shell), and whether the app needs its OWN users → the aimeat-iam pack, decided NOW, not retrofitted.\n\n';
+    p += '## 3. Propose\n';
+    p += 'Give me the frame in 3-5 lines (tier, packs, start point, iam yes/no, anything you will reuse) and wait for my go-ahead or corrections.\n\n';
+    p += '## 4. Build\n';
+    p += 'Build within the frame but stay flexible — building teaches; when reality disagrees with the frame, say so and adapt. Verify locally before publishing; publish over MCP (presigned upload for anything over ~1 KB).\n\n';
+    p += '## 5. Finish (this is where the acceleration compounds)\n';
+    p += buildFinishChecklist();
+    p += '\n';
+    p += `## Skipping\n`;
+    p += `If I say "${FLOW_SKIP_PHRASE}" (or anything to that effect), skip steps 1-3 and build directly — the flow is the default, never a gate.\n`;
+    return p;
+}
+//# sourceMappingURL=appdev-flow-prompt.js.map

package/dist/src/services/appdev-flow-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appdev-flow-prompt.js","sourceRoot":"","sources":["../../../src/services/appdev-flow-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAE7G,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,CAAC,IAAI,wDAAwD,CAAC;IAC9D,CAAC,IAAI,wFAAwF,CAAC;IAC9F,CAAC,IAAI,0FAA0F,WAAW,MAAM,CAAC;IACjH,CAAC,IAAI,yHAAyH,CAAC;IAC/H,CAAC,IAAI,uBAAuB,CAAC;IAC7B,CAAC,IAAI,kaAAka,CAAC;IACxa,CAAC,IAAI,oCAAoC,CAAC;IAC1C,CAAC,IAAI,kCAAkC,UAAU,CAAC,QAAQ,YAAY,UAAU,CAAC,KAAK,OAAO,CAAC;IAC9F,CAAC,IAAI,wCAAwC,UAAU,CAAC,QAAQ,mRAAmR,CAAC;IACpV,CAAC,IAAI,+DAA+D,OAAO,+DAA+D,CAAC;IAC3I,CAAC,IAAI,eAAe,CAAC;IACrB,CAAC,IAAI,4PAA4P,CAAC;IAClQ,CAAC,IAAI,iBAAiB,CAAC;IACvB,CAAC,IAAI,6IAA6I,CAAC;IACnJ,CAAC,IAAI,eAAe,CAAC;IACrB,CAAC,IAAI,0NAA0N,CAAC;IAChO,CAAC,IAAI,2DAA2D,CAAC;IACjE,CAAC,IAAI,oBAAoB,EAAE,CAAC;IAC5B,CAAC,IAAI,IAAI,CAAC;IACV,CAAC,IAAI,eAAe,CAAC;IACrB,CAAC,IAAI,aAAa,gBAAgB,8GAA8G,CAAC;IACjJ,OAAO,CAAC,CAAC;AACb,CAAC"}

package/dist/src/services/appdev-kb.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @file appdev-kb.ts
+ * @description Shared service layer of the learned AppDev knowledge base — the one place that
+ *   knows the storage conventions of learned pitfalls (reserved knowledge package
+ *   `packages/appdev-pitfalls/{category}/{slug}`, owner-scope aggregation, manifest upkeep)
+ *   so the MCP tools (mcp/appdev-pitfalls.ts) and the profile-UI REST routes
+ *   (routes/appdev-pitfalls.ts) can never drift. Owner scope = the owner GHII + every
+ *   same-owner agent GAII, deduped by key GHII-first.
+ * @structure listOwnerScopeMemory · findOwnEntry · listLearnedPitfalls · setPitfallFlags ·
+ *   deletePitfallEntry · upsertPitfallManifest · PITFALL_* constants
+ * @usage import { listLearnedPitfalls, setPitfallFlags } from './appdev-kb.js';
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — extracted from mcp/appdev-pitfalls.ts + extended with the UI
+ *     management operations (share/status flags, full-body listing) (AppDev KB UI phase).
+ */
+import type { AimeatConfig } from '../config.js';
+import type { Storage, MemoryRecord } from '../storage/interface.js';
+export declare const PITFALL_PACKAGE_ID = "appdev-pitfalls";
+export declare const PITFALL_PREFIX = "packages/appdev-pitfalls/";
+export declare const PITFALL_MANIFEST_KEY = "packages/appdev-pitfalls/manifest";
+export declare const PITFALL_SLUG_RE: RegExp;
+export interface LearnedPitfallValue {
+    title: string;
+    symptom: string;
+    resolution: string;
+    model: string;
+    category: string;
+    slug: string;
+    applies_to: string[];
+    severity: 'info' | 'warn' | 'critical';
+    status: 'active' | 'outdated';
+    app_ref?: string;
+    reported_by: string;
+    created: string;
+    updated: string;
+}
+export declare function slugifyKb(s: string): string;
+/** Owner-scope memory aggregation (GHII + all same-owner agents), deduped by key GHII-first. */
+export declare function listOwnerScopeMemory(storage: Storage, config: AimeatConfig, callerGaii: string, opts: {
+    prefix?: string;
+    tags?: string[];
+}): Promise<MemoryRecord[]>;
+/** The identity set (GHII + agent GAIIs) of the caller's owner — for own/other filtering. */
+export declare function ownIdentitySet(storage: Storage, config: AimeatConfig, callerGaii: string): Promise<Set<string>>;
+/** Find one of the caller's own KB records by exact key (across the owner identity set). */
+export declare function findOwnEntry(storage: Storage, config: AimeatConfig, callerGaii: string, key: string): Promise<MemoryRecord | null>;
+/** Keep the reserved package manifest's entries list in sync (add/replace/remove one ref). */
+export declare function upsertPitfallManifest(storage: Storage, config: AimeatConfig, callerGaii: string, entryKey: string, title: string, remove?: boolean): Promise<void>;
+export interface LearnedPitfallEntry extends Partial<LearnedPitfallValue> {
+    key: string;
+    shared: boolean;
+    /** 'own' = the caller's owner scope; 'shared' = another owner's public entry. */
+    source: 'own' | 'shared';
+    owner?: string;
+}
+/**
+ * Full-body learned-pitfall listing for the UI: the caller's own entries (any visibility)
+ * and, with includeShared, other owners' public entries. Curated registry entries are NOT
+ * merged here — the UI reads them from GET /v1/appdev/pitfalls directly.
+ */
+export declare function listLearnedPitfalls(storage: Storage, config: AimeatConfig, callerGaii: string, opts?: {
+    includeShared?: boolean;
+}): Promise<LearnedPitfallEntry[]>;
+/** Toggle the share (visibility) and/or status flags on one of the caller's own entries. */
+export declare function setPitfallFlags(storage: Storage, config: AimeatConfig, callerGaii: string, category: string, slug: string, flags: {
+    share?: boolean;
+    status?: 'active' | 'outdated';
+}): Promise<LearnedPitfallEntry | null>;
+/** Delete one of the caller's own entries (record + manifest ref). */
+export declare function deletePitfallEntry(storage: Storage, config: AimeatConfig, callerGaii: string, category: string, slug: string): Promise<boolean>;
+//# sourceMappingURL=appdev-kb.d.ts.map

package/dist/src/services/appdev-kb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appdev-kb.d.ts","sourceRoot":"","sources":["../../../src/services/appdev-kb.ts"],"names":[],"mappings":"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"}

package/dist/src/services/appdev-kb.js

@@ -0,0 +1,178 @@
+/**
+ * @file appdev-kb.ts
+ * @description Shared service layer of the learned AppDev knowledge base — the one place that
+ *   knows the storage conventions of learned pitfalls (reserved knowledge package
+ *   `packages/appdev-pitfalls/{category}/{slug}`, owner-scope aggregation, manifest upkeep)
+ *   so the MCP tools (mcp/appdev-pitfalls.ts) and the profile-UI REST routes
+ *   (routes/appdev-pitfalls.ts) can never drift. Owner scope = the owner GHII + every
+ *   same-owner agent GAII, deduped by key GHII-first.
+ * @structure listOwnerScopeMemory · findOwnEntry · listLearnedPitfalls · setPitfallFlags ·
+ *   deletePitfallEntry · upsertPitfallManifest · PITFALL_* constants
+ * @usage import { listLearnedPitfalls, setPitfallFlags } from './appdev-kb.js';
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — extracted from mcp/appdev-pitfalls.ts + extended with the UI
+ *     management operations (share/status flags, full-body listing) (AppDev KB UI phase).
+ */
+import { parseGAII } from '../utils/gaii.js';
+export const PITFALL_PACKAGE_ID = 'appdev-pitfalls';
+export const PITFALL_PREFIX = `packages/${PITFALL_PACKAGE_ID}/`;
+export const PITFALL_MANIFEST_KEY = `packages/${PITFALL_PACKAGE_ID}/manifest`;
+export const PITFALL_SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+export function slugifyKb(s) {
+    return s.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 64) || 'entry';
+}
+function ownerOf(callerGaii, _config) {
+    const parsed = parseGAII(callerGaii);
+    if (parsed?.owner)
+        return parsed.owner;
+    if (callerGaii.includes('@') && !callerGaii.includes('#'))
+        return callerGaii.split('@')[0];
+    return null;
+}
+/** Owner-scope memory aggregation (GHII + all same-owner agents), deduped by key GHII-first. */
+export async function listOwnerScopeMemory(storage, config, callerGaii, opts) {
+    const owner = ownerOf(callerGaii, config);
+    if (!owner)
+        return storage.listMemory(callerGaii, opts);
+    const ownerGhii = `${owner}@${config.nodeId}`;
+    const agents = await storage.getAgentsByOwner(owner);
+    const owners = [ownerGhii, ...agents.map(a => a.gaii)];
+    const priority = new Map(owners.map((g, i) => [g, i]));
+    const rows = await storage.listMemoryForOwners(owners, opts);
+    rows.sort((x, y) => (priority.get(x.ownerGaii) ?? 0) - (priority.get(y.ownerGaii) ?? 0));
+    const seen = new Set();
+    const out = [];
+    for (const rec of rows) {
+        if (!seen.has(rec.key)) {
+            seen.add(rec.key);
+            out.push(rec);
+        }
+    }
+    return out;
+}
+/** The identity set (GHII + agent GAIIs) of the caller's owner — for own/other filtering. */
+export async function ownIdentitySet(storage, config, callerGaii) {
+    const owner = ownerOf(callerGaii, config);
+    if (!owner)
+        return new Set([callerGaii]);
+    const agents = await storage.getAgentsByOwner(owner);
+    return new Set([`${owner}@${config.nodeId}`, ...agents.map(a => a.gaii)]);
+}
+/** Find one of the caller's own KB records by exact key (across the owner identity set). */
+export async function findOwnEntry(storage, config, callerGaii, key) {
+    const rows = await listOwnerScopeMemory(storage, config, callerGaii, { prefix: key });
+    return rows.find(r => r.key === key) ?? null;
+}
+/** Keep the reserved package manifest's entries list in sync (add/replace/remove one ref). */
+export async function upsertPitfallManifest(storage, config, callerGaii, entryKey, title, remove = false) {
+    const now = new Date().toISOString();
+    const existing = await findOwnEntry(storage, config, callerGaii, PITFALL_MANIFEST_KEY);
+    const value = existing?.value ?? {
+        name: 'AppDev pitfalls (learned)',
+        content_type: 'appdev-pitfalls',
+        tags: ['pitfall'],
+        entries: [],
+    };
+    const entries = Array.isArray(value.entries) ? value.entries : [];
+    const idx = entries.findIndex(e => e.key === entryKey);
+    if (remove) {
+        if (idx === -1)
+            return;
+        entries.splice(idx, 1);
+    }
+    else if (idx === -1) {
+        entries.push({ key: entryKey, title });
+    }
+    else {
+        entries[idx] = { key: entryKey, title };
+    }
+    value.entries = entries;
+    value.updated = now;
+    await storage.setMemory({
+        key: PITFALL_MANIFEST_KEY,
+        ownerGaii: existing?.ownerGaii ?? callerGaii,
+        value,
+        visibility: existing?.visibility ?? 'owner',
+        tags: existing?.tags ?? ['knowledge-package', 'pitfall'],
+        ttlHours: null,
+        version: (existing?.version ?? 0) + 1,
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
+    });
+}
+function toEntry(rec, source) {
+    const v = rec.value;
+    return {
+        key: rec.key,
+        source,
+        shared: rec.visibility === 'public',
+        ...(source === 'shared' ? { owner: rec.ownerGaii } : {}),
+        title: v?.title ?? rec.key,
+        symptom: v?.symptom,
+        resolution: v?.resolution,
+        model: v?.model,
+        category: v?.category,
+        slug: v?.slug,
+        applies_to: v?.applies_to ?? [],
+        severity: v?.severity ?? 'warn',
+        status: v?.status ?? 'active',
+        app_ref: v?.app_ref,
+        updated: v?.updated ?? rec.updatedAt,
+    };
+}
+/**
+ * Full-body learned-pitfall listing for the UI: the caller's own entries (any visibility)
+ * and, with includeShared, other owners' public entries. Curated registry entries are NOT
+ * merged here — the UI reads them from GET /v1/appdev/pitfalls directly.
+ */
+export async function listLearnedPitfalls(storage, config, callerGaii, opts = {}) {
+    const own = (await listOwnerScopeMemory(storage, config, callerGaii, { prefix: PITFALL_PREFIX, tags: ['pitfall'] }))
+        .filter(r => r.key !== PITFALL_MANIFEST_KEY)
+        .map(r => toEntry(r, 'own'));
+    if (!opts.includeShared)
+        return own;
+    const ownIds = await ownIdentitySet(storage, config, callerGaii);
+    const { items } = await storage.listAllMemory({ prefix: PITFALL_PREFIX, visibility: 'public', limit: 500 });
+    const shared = items
+        .filter(rec => rec.key !== PITFALL_MANIFEST_KEY)
+        .filter(rec => !ownIds.has(rec.ownerGaii))
+        .filter(rec => (rec.tags ?? []).includes('pitfall'))
+        .map(rec => toEntry(rec, 'shared'));
+    return [...own, ...shared];
+}
+/** Toggle the share (visibility) and/or status flags on one of the caller's own entries. */
+export async function setPitfallFlags(storage, config, callerGaii, category, slug, flags) {
+    const key = `${PITFALL_PREFIX}${slugifyKb(category)}/${slug.toLowerCase()}`;
+    const existing = await findOwnEntry(storage, config, callerGaii, key);
+    if (!existing)
+        return null;
+    const now = new Date().toISOString();
+    const value = { ...existing.value };
+    if (flags.status) {
+        value.status = flags.status;
+        value.updated = now;
+    }
+    const visibility = flags.share === undefined
+        ? existing.visibility
+        : flags.share ? 'public' : 'owner';
+    const updated = {
+        ...existing,
+        value,
+        visibility,
+        version: (existing.version ?? 0) + 1,
+        updatedAt: now,
+    };
+    await storage.setMemory(updated);
+    return toEntry(updated, 'own');
+}
+/** Delete one of the caller's own entries (record + manifest ref). */
+export async function deletePitfallEntry(storage, config, callerGaii, category, slug) {
+    const key = `${PITFALL_PREFIX}${slugifyKb(category)}/${slug.toLowerCase()}`;
+    const existing = await findOwnEntry(storage, config, callerGaii, key);
+    if (!existing)
+        return false;
+    await storage.deleteMemory(existing.ownerGaii, key);
+    await upsertPitfallManifest(storage, config, callerGaii, key, '', true);
+    return true;
+}
+//# sourceMappingURL=appdev-kb.js.map

package/dist/src/services/appdev-kb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appdev-kb.js","sourceRoot":"","sources":["../../../src/services/appdev-kb.ts"],"names":[],"mappings":"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"}

package/dist/src/services/appdev-overview.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @file appdev-overview.ts
+ * @description The "big picture" research surface for AI agents building apps ON AIMEAT —
+ *   one call returns compact INDEXES of everything relevant to framing a build: the owner's
+ *   existing apps (best templates), library packs (with per-model AEB proof summaries),
+ *   app-shell templates (T1/T2/T3), skills (the paved-path builder skill first), curated +
+ *   learned pitfalls (model-faceted), and the owner's agent-proposed template proposals.
+ *   Progressive disclosure by design: indexes only, hard caps per list, drill-down via the
+ *   existing endpoints/tools each section names. Scope: app development on the platform only.
+ * @structure buildAppdevOverview(storage, config, callerGaii, opts) → AppdevOverview
+ * @usage
+ *   import { buildAppdevOverview } from '../services/appdev-overview.js';
+ *   const overview = await buildAppdevOverview(storage, config, identity, { model, sections });
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — initial (AppDev KB Phase 5).
+ */
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+export declare const OVERVIEW_SECTIONS: readonly ["apps", "library_packs", "app_templates", "skills", "pitfalls_curated", "pitfalls_learned", "template_proposals"];
+export type OverviewSection = (typeof OVERVIEW_SECTIONS)[number];
+export interface AppdevOverviewOpts {
+    /** Indicative model filter — marks matching pack proofs and filters learned pitfalls. */
+    model?: string;
+    /** Subset of sections to build (token economy); default all. */
+    sections?: string[];
+}
+export declare function buildAppdevOverview(storage: Storage, config: AimeatConfig, callerGaii: string, opts?: AppdevOverviewOpts): Promise<Record<string, unknown>>;
+//# sourceMappingURL=appdev-overview.d.ts.map

package/dist/src/services/appdev-overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appdev-overview.d.ts","sourceRoot":"","sources":["../../../src/services/appdev-overview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,yBAAyB,CAAC;AASrE,eAAO,MAAM,iBAAiB,6HAGpB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IAC/B,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAoCD,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,kBAAuB,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0IlC"}