@owlmeans/agent-skills 0.1.15 → 0.1.16

package/tests/installer.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect, beforeEach, afterEach } from 'bun:test'
-import { existsSync, mkdirSync, readFileSync, rmSync, symlinkSync, writeFileSync } from 'node:fs'
+import { existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, rmSync, symlinkSync, writeFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { tmpdir } from 'node:os'
 
@@ -14,12 +14,16 @@ import { applyInstall } from '../src/apply.js'
 
 const BANNER = AUTO_GENERATED_BANNER
 
+/** Where a skill lands in the target project. */
+const skillTarget = (root: string, name: string): string =>
+  join(root, '.agents', 'skills', name, 'SKILL.md')
+
 const makeFixtureManifest = (pkgName: string, version: string, entries: Array<{
   kind: 'skill' | 'instruction'
   name: string
   category?: 'package-specific' | 'multi-package'
-}>) => ({
-  schemaVersion: 1,
+}>, schemaVersion = 2) => ({
+  schemaVersion,
   package: pkgName,
   version,
   generatedAt: '2026-06-10T00:00:00Z',
@@ -32,7 +36,7 @@ const makeFixtureManifest = (pkgName: string, version: string, entries: Array<{
       ? `skills/${e.name}/SKILL.md`
       : `instructions/${e.name}.instructions.md`,
     canonicalPath: e.kind === 'skill'
-      ? `.claude/skills/${e.name}/SKILL.md`
+      ? `.agents/skills/${e.name}/SKILL.md`
       : `.github/instructions/${e.name}.instructions.md`,
   })),
 })
@@ -42,13 +46,14 @@ const writeFixturePackage = (
   pkgName: string,
   version: string,
   entries: Array<{ kind: 'skill' | 'instruction'; name: string }>,
+  schemaVersion = 2,
 ): void => {
   const pkgDir = join(nmDir, '@owlmeans', pkgName.replace('@owlmeans/', ''))
   const agentMetaDir = join(pkgDir, 'agent-meta')
   mkdirSync(join(agentMetaDir, 'skills'), { recursive: true })
   mkdirSync(join(agentMetaDir, 'instructions'), { recursive: true })
 
-  const manifest = makeFixtureManifest(pkgName, version, entries)
+  const manifest = makeFixtureManifest(pkgName, version, entries, schemaVersion)
   writeFileSync(join(agentMetaDir, 'manifest.json'), JSON.stringify(manifest, null, 2), 'utf8')
 
   for (const e of entries) {
@@ -90,18 +95,26 @@ describe('discover()', () => {
     expect(entries).toEqual([])
   })
 
-  it('discovers entries from node_modules', () => {
+  it('discovers skills from node_modules', () => {
     writeFixturePackage(join(tmpDir, 'node_modules'), '@owlmeans/context', '0.1.7', [
       { kind: 'skill', name: 'context' },
-      { kind: 'instruction', name: 'context' },
     ])
     const entries = discover(tmpDir, { extras: false })
-    expect(entries).toHaveLength(2)
-    expect(entries.some(e => e.kind === 'skill' && e.name === 'context')).toBe(true)
-    expect(entries.some(e => e.kind === 'instruction' && e.name === 'context')).toBe(true)
+    expect(entries).toHaveLength(1)
+    expect(entries[0].name).toBe('context')
+  })
+
+  it('drops instruction entries published by pre-v2 packages', () => {
+    writeFixturePackage(join(tmpDir, 'node_modules'), '@owlmeans/context', '0.1.7', [
+      { kind: 'skill', name: 'context' },
+      { kind: 'instruction', name: 'context' },
+    ], 1)
+    const entries = discover(tmpDir, { extras: false })
+    expect(entries).toHaveLength(1)
+    expect(entries.every(e => e.kind === 'skill')).toBe(true)
   })
 
-  it('deduplicates by (kind, name), keeping highest version', () => {
+  it('deduplicates by name, keeping highest version', () => {
     writeFixturePackage(join(tmpDir, 'node_modules'), '@owlmeans/context', '0.1.5', [
       { kind: 'skill', name: 'context' },
     ])
@@ -125,37 +138,17 @@ describe('discover()', () => {
     expect(entries[0].name).toBe('context')
   })
 
-  it('--claude-only filter', () => {
-    writeFixturePackage(join(tmpDir, 'node_modules'), '@owlmeans/context', '0.1.7', [
-      { kind: 'skill', name: 'context' },
-      { kind: 'instruction', name: 'context' },
-    ])
-    const entries = discover(tmpDir, { extras: false, claudeOnly: true })
-    expect(entries.every(e => e.kind === 'skill')).toBe(true)
-  })
-
-  it('--copilot-only filter', () => {
-    writeFixturePackage(join(tmpDir, 'node_modules'), '@owlmeans/context', '0.1.7', [
-      { kind: 'skill', name: 'context' },
-      { kind: 'instruction', name: 'context' },
-    ])
-    const entries = discover(tmpDir, { extras: false, copilotOnly: true })
-    expect(entries.every(e => e.kind === 'instruction')).toBe(true)
-  })
-
   it('discovers entries nested in workspace package node_modules (bun monorepo)', () => {
     // Scaffolded bun workspace: root has no @owlmeans; deps live under sources/*.
     writeFixturePackage(join(tmpDir, 'sources', 'web', 'node_modules'), '@owlmeans/web-panel', '0.1.9', [
       { kind: 'skill', name: 'web-panel' },
-      { kind: 'instruction', name: 'web-panel' },
     ])
     writeFixturePackage(join(tmpDir, 'sources', 'api', 'node_modules'), '@owlmeans/server-app', '0.1.9', [
       { kind: 'skill', name: 'server-app' },
     ])
     const entries = discover(tmpDir, { extras: false })
-    expect(entries.some(e => e.kind === 'skill' && e.name === 'web-panel')).toBe(true)
-    expect(entries.some(e => e.kind === 'instruction' && e.name === 'web-panel')).toBe(true)
-    expect(entries.some(e => e.kind === 'skill' && e.name === 'server-app')).toBe(true)
+    expect(entries.some(e => e.name === 'web-panel')).toBe(true)
+    expect(entries.some(e => e.name === 'server-app')).toBe(true)
   })
 
   it('combines root and nested node_modules', () => {
@@ -231,7 +224,7 @@ describe('detectLinked()', () => {
 // ---------------------------------------------------------------------------
 
 describe('planInstall()', () => {
-  it('marks missing targets as install', () => {
+  it('targets .agents/skills and marks missing targets as install', () => {
     writeFixturePackage(join(tmpDir, 'node_modules'), '@owlmeans/context', '0.1.7', [
       { kind: 'skill', name: 'context' },
     ])
@@ -239,6 +232,7 @@ describe('planInstall()', () => {
     const items = planInstall(entries, tmpDir)
     expect(items).toHaveLength(1)
     expect(items[0].action).toBe('install')
+    expect(items[0].targetPath).toBe(skillTarget(tmpDir, 'context'))
   })
 
   it('marks identical files as skip-uptodate', () => {
@@ -247,7 +241,7 @@ describe('planInstall()', () => {
     ])
     const entries = discover(tmpDir, { extras: false })
     // Write same content to target
-    const targetDir = join(tmpDir, '.claude', 'skills', 'context')
+    const targetDir = join(tmpDir, '.agents', 'skills', 'context')
     mkdirSync(targetDir, { recursive: true })
     const source = readFileSync(entries[0].sourcePath, 'utf8')
     writeFileSync(join(targetDir, 'SKILL.md'), source, 'utf8')
@@ -261,7 +255,7 @@ describe('planInstall()', () => {
       { kind: 'skill', name: 'context' },
     ])
     const entries = discover(tmpDir, { extras: false })
-    const targetDir = join(tmpDir, '.claude', 'skills', 'context')
+    const targetDir = join(tmpDir, '.agents', 'skills', 'context')
     mkdirSync(targetDir, { recursive: true })
     // Write old managed content (has banner, but different)
     writeFileSync(join(targetDir, 'SKILL.md'), `${BANNER}\n# Old content\n`, 'utf8')
@@ -275,7 +269,7 @@ describe('planInstall()', () => {
       { kind: 'skill', name: 'context' },
     ])
     const entries = discover(tmpDir, { extras: false })
-    const targetDir = join(tmpDir, '.claude', 'skills', 'context')
+    const targetDir = join(tmpDir, '.agents', 'skills', 'context')
     mkdirSync(targetDir, { recursive: true })
     writeFileSync(join(targetDir, 'SKILL.md'), '# My custom skill\n', 'utf8')
 
@@ -288,7 +282,7 @@ describe('planInstall()', () => {
       { kind: 'skill', name: 'context' },
     ])
     const entries = discover(tmpDir, { extras: false })
-    const targetDir = join(tmpDir, '.claude', 'skills', 'context')
+    const targetDir = join(tmpDir, '.agents', 'skills', 'context')
     mkdirSync(targetDir, { recursive: true })
     writeFileSync(join(targetDir, 'SKILL.md'), '# My custom skill\n', 'utf8')
 
@@ -298,21 +292,19 @@ describe('planInstall()', () => {
 })
 
 // ---------------------------------------------------------------------------
-// applyInstall() — idempotency
+// applyInstall() — idempotency and the Claude Code bridge
 // ---------------------------------------------------------------------------
 
 describe('applyInstall()', () => {
-  it('writes install items', () => {
+  it('writes install items into .agents/skills', () => {
     writeFixturePackage(join(tmpDir, 'node_modules'), '@owlmeans/context', '0.1.7', [
       { kind: 'skill', name: 'context' },
-      { kind: 'instruction', name: 'context' },
     ])
     const entries = discover(tmpDir, { extras: false })
     const items = planInstall(entries, tmpDir)
     const result = applyInstall(items)
-    expect(result.installed).toBe(2)
-    expect(existsSync(join(tmpDir, '.claude', 'skills', 'context', 'SKILL.md'))).toBe(true)
-    expect(existsSync(join(tmpDir, '.github', 'instructions', 'context.instructions.md'))).toBe(true)
+    expect(result.installed).toBe(1)
+    expect(existsSync(skillTarget(tmpDir, 'context'))).toBe(true)
   })
 
   it('is idempotent — second run yields all skip-uptodate', () => {
@@ -335,7 +327,7 @@ describe('applyInstall()', () => {
       { kind: 'skill', name: 'context' },
     ])
     const entries = discover(tmpDir, { extras: false })
-    const targetDir = join(tmpDir, '.claude', 'skills', 'context')
+    const targetDir = join(tmpDir, '.agents', 'skills', 'context')
     mkdirSync(targetDir, { recursive: true })
     const localContent = '# My custom skill\n'
     writeFileSync(join(targetDir, 'SKILL.md'), localContent, 'utf8')
@@ -345,4 +337,28 @@ describe('applyInstall()', () => {
     // File should remain unchanged
     expect(readFileSync(join(targetDir, 'SKILL.md'), 'utf8')).toBe(localContent)
   })
+
+  it('symlinks installed skills into .claude/skills when the project uses Claude Code', () => {
+    writeFixturePackage(join(tmpDir, 'node_modules'), '@owlmeans/context', '0.1.7', [
+      { kind: 'skill', name: 'context' },
+    ])
+    mkdirSync(join(tmpDir, '.claude'), { recursive: true })
+    const entries = discover(tmpDir, { extras: false })
+    const result = applyInstall(planInstall(entries, tmpDir), tmpDir)
+
+    const link = join(tmpDir, '.claude', 'skills', 'context')
+    expect(result.linked).toBe(1)
+    expect(lstatSync(link).isSymbolicLink()).toBe(true)
+    expect(readlinkSync(link)).toBe(join('..', '..', '.agents', 'skills', 'context'))
+  })
+
+  it('leaves a project without .claude/ untouched', () => {
+    writeFixturePackage(join(tmpDir, 'node_modules'), '@owlmeans/context', '0.1.7', [
+      { kind: 'skill', name: 'context' },
+    ])
+    const entries = discover(tmpDir, { extras: false })
+    const result = applyInstall(planInstall(entries, tmpDir), tmpDir)
+    expect(result.linked).toBe(0)
+    expect(existsSync(join(tmpDir, '.claude'))).toBe(false)
+  })
 })

package/tests/llm-plugin.test.ts

@@ -0,0 +1,158 @@
+import { describe, expect, test } from 'bun:test'
+import { PromptBlock } from '@owlmeans/llm-common'
+import type { LlmFileProvider } from '@owlmeans/llm-common'
+import { anthropicPlugin, makePromptService } from '@owlmeans/llm'
+import type { ModelConfig, PromptService } from '@owlmeans/llm'
+import { owlmeansPackagesPlugin, stripMeta, unscoped } from '@owlmeans/agent-skills/llm'
+
+const model = anthropicPlugin.build({
+  alias: 'spec',
+  secret: 'sk-test',
+  callbacks: [],
+  config: { alias: 'spec', model: 'claude-haiku-4-5-20251001' } as ModelConfig,
+})
+
+let seq = 0
+const compose = (svc: PromptService, text: string) =>
+  svc.compose({}, [{ role: 'user', content: text }], { model, provider: anthropicPlugin })
+
+const withPlugin = (options: Parameters<typeof owlmeansPackagesPlugin>[0] = {}): PromptService =>
+  makePromptService(
+    { plugins: [owlmeansPackagesPlugin({ fetch: false, ...options })] },
+    `spec-pkg-${seq++}`,
+  )
+
+/** A host file provider that serves one package, recording every path it is asked for. */
+const fakeProvider = (asked: string[], body: string): LlmFileProvider => ({
+  getSourceList: async () => [],
+  writeFile: async () => { },
+  deleteFile: async () => { },
+  readFile: async path => {
+    asked.push(path)
+    if (path.endsWith('manifest.json')) {
+      return JSON.stringify({
+        schemaVersion: 1,
+        package: '@owlmeans/auth',
+        version: '9.9.9',
+        generatedAt: '',
+        canonicalRepo: '',
+        entries: [{
+          kind: 'skill',
+          name: 'auth',
+          category: 'package-specific',
+          file: 'skills/auth/SKILL.md',
+          canonicalPath: '.claude/skills/auth/SKILL.md',
+        }],
+      })
+    }
+    return `---\nname: auth\n---\n${body}`
+  },
+})
+
+describe('@owlmeans/agent-skills — embedded metadata', () => {
+  test('frontmatter and the generated banner are stripped from a skill body', () => {
+    const body = stripMeta([
+      '---',
+      'name: auth',
+      'description: something',
+      '---',
+      '<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->',
+      '',
+      '# @owlmeans/auth',
+    ].join('\n'))
+    expect(body).toBe('# @owlmeans/auth')
+  })
+
+  test('content without frontmatter survives untouched', () => {
+    expect(stripMeta('# Plain\n\nbody')).toBe('# Plain\n\nbody')
+  })
+
+  test('the repo lays packages out under their unscoped name', () => {
+    expect(unscoped('@owlmeans/llm-common')).toBe('llm-common')
+  })
+})
+
+describe('@owlmeans/agent-skills — package skills plugin', () => {
+  test('a mentioned package contributes its skills to the packages block', async () => {
+    const result = await compose(withPlugin(), 'How do I use @owlmeans/auth in a handler?')
+    const packages = result.blocks.find(block => block.block === PromptBlock.Packages)
+    expect(packages?.text).toContain('@owlmeans/auth — auth')
+  })
+
+  test('a package nobody mentioned is not loaded', async () => {
+    const result = await compose(withPlugin(), 'How do I write a handler?')
+    expect(result.blocks.find(block => block.block === PromptBlock.Packages)).toBeUndefined()
+  })
+
+  test('an excluded package is skipped even when mentioned', async () => {
+    const result = await compose(
+      withPlugin({ exclude: ['@owlmeans/auth'] }), 'How do I use @owlmeans/auth?'
+    )
+    expect(result.blocks.find(block => block.block === PromptBlock.Packages)).toBeUndefined()
+  })
+
+  // Two prompts that name the same packages in a different order must produce the same
+  // bytes, or they can never share a cache entry.
+  test('mention order does not change the composed bytes', async () => {
+    const first = await compose(withPlugin(), 'compare @owlmeans/auth with @owlmeans/context')
+    const second = await compose(withPlugin(), 'compare @owlmeans/context with @owlmeans/auth')
+    const packages = (result: typeof first) =>
+      result.blocks.find(block => block.block === PromptBlock.Packages)?.text
+    expect(packages(second)).toBe(packages(first))
+  })
+
+  test('trailing punctuation is not part of the package name', async () => {
+    const result = await compose(withPlugin(), 'What about @owlmeans/auth. And @owlmeans/auth,')
+    expect(result.blocks.find(block => block.block === PromptBlock.Packages)?.text)
+      .toContain('@owlmeans/auth — auth')
+  })
+
+  test('a provider wired at construction is preferred over the local filesystem', async () => {
+    const asked: string[] = []
+    const files = fakeProvider(asked, 'HOSTED BODY')
+    const result = await compose(withPlugin({ files: () => files }), 'about @owlmeans/auth')
+    expect(asked[0]).toBe('node_modules/@owlmeans/auth/agent-meta/manifest.json')
+    expect(result.blocks.find(block => block.block === PromptBlock.Packages)?.text)
+      .toContain('HOSTED BODY')
+  })
+
+  // The host's provider is per-execution (a sandbox, a slot, one checkout), so it can only
+  // arrive on the compose context — a plugin built once at context composition cannot know
+  // it. Reading only the constructor option left this path dead.
+  test('a provider supplied on the compose context is used and preferred', async () => {
+    const asked: string[] = []
+    const files = fakeProvider(asked, 'CONTEXT BODY')
+    const svc = withPlugin()
+    const result = await svc.compose(
+      {},
+      [{ role: 'user', content: 'about @owlmeans/auth' }],
+      { model, provider: anthropicPlugin, files: () => files },
+    )
+    expect(asked[0]).toBe('node_modules/@owlmeans/auth/agent-meta/manifest.json')
+    expect(result.blocks.find(block => block.block === PromptBlock.Packages)?.text)
+      .toContain('CONTEXT BODY')
+  })
+
+  test('two providers do not share each other\'s cached packages', async () => {
+    const svc = withPlugin()
+    const one = fakeProvider([], 'FIRST PROJECT')
+    const two = fakeProvider([], 'SECOND PROJECT')
+    const run = (files: LlmFileProvider) => svc.compose(
+      {},
+      [{ role: 'user', content: 'about @owlmeans/auth' }],
+      { model, provider: anthropicPlugin, files: () => files },
+    )
+    const first = await run(one)
+    const second = await run(two)
+    const packages = (r: typeof first) =>
+      r.blocks.find(block => block.block === PromptBlock.Packages)?.text
+    expect(packages(first)).toContain('FIRST PROJECT')
+    expect(packages(second)).toContain('SECOND PROJECT')
+  })
+
+  // A prompt plugin that throws takes the whole model call with it.
+  test('an unreachable package degrades the prompt instead of failing the call', async () => {
+    const result = await compose(withPlugin(), 'about @owlmeans/does-not-exist-anywhere')
+    expect(result.blocks.find(block => block.block === PromptBlock.Packages)).toBeUndefined()
+  })
+})

package/agent-meta/instructions/agent-memory.instructions.md

@@ -1,143 +0,0 @@
----
-description: "Shared agent memory protocol for the .agents/memory/ graph store (single store for Copilot and Claude Code) — MEMORY.md index, subsystem nodes, compact-on-write, size caps, read protocol. Apply when reading or writing project memory, or when any legacy .claude/memory or .github/memory path appears."
-applyTo: "**/.agents/memory/**, **/.claude/memory/**, **/.github/memory/**"
-scope: general
----
-<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
-
-# Agent memory (`.agents/memory/`)
-
-One shared memory store per repository, used by **both** GitHub Copilot and Claude Code: a graph
-of subsystem nodes rooted in the `MEMORY.md` index. Compactness is the core value — every write
-merges and compacts; nothing is ever appended as a log.
-
-Never write memory to `.claude/memory/`, `.github/memory/`, `~/.copilot/`, `~/.claude/`, or
-anywhere outside the repository. Legacy `.claude/memory/` / `.github/memory/` stores are
-retired — if one exists, flag it for migration
-(`.github/instructions/memory-recompact.instructions.md`) instead of writing there.
-
-## Store layout
-
-```
-.agents/memory/
-├── MEMORY.md     # graph root: the only always-read file
-└── <node>.md     # one file per subsystem / concern / integration
-```
-
-Flat directory — graph structure lives in scopes and wiki-links, not subdirectories.
-
-## Node naming
-
-Node id = lowercase-kebab name of the **project-structure part** the knowledge attaches to:
-
-1. **Subsystem** — workspace dir / package name: `manager-web`, `auth`, `vslots`. Deepest
-   unambiguous segment; prefix with the parent only on collision.
-2. **Cross-cutting concern** spanning subsystems: `build`, `testing`, `deploy`, `routing`, `i18n`.
-3. **Integration** — external service/library: `stripe`, `cloudflare`, `openrouter`.
-4. **`workspace`** — repo-level facts that fit nowhere else (remotes, branch topology, env model).
-
-File is `<node>.md`; the id is the wiki-link target: `[[manager-web]]`. **Never** key a node to an
-event, date, phase, investigation, or task name.
-
-## Index format (`MEMORY.md`)
-
-```markdown
-# Memory Graph — <project>
-
-Shared agent memory (`agent-memory` protocol). Read this file at session start.
-Before non-trivial work, open every node whose scope matches the task's files or topics.
-
-## Subsystems
-- [[manager-web]] `sources/manager-web/**` — i18n 8-domain split; owl-theme wiring
-## Cross-cutting
-- [[build]] `**/tsconfig*.json` — tsbuildinfo path pinning; tolerant library builds
-## Integrations
-- [[stripe]] `ext:stripe` — sandbox topology; webhook fan-out
-```
-
-Rules: exactly one line per node — `- [[<node>]] ` + backticked scope + ` — <hook>`; hook ≤ 100
-chars; no dates; only non-empty groups; file ≤ 50 lines; no skills listed (skills self-describe).
-The scope column is the router: match the task's paths/topics against scopes to decide which
-nodes to open.
-
-## Node format
-
-Frontmatter — exactly three fields:
-
-```yaml
----
-node: vslots                 # = filename without .md; = wiki-link target
-scope: "scripts/vslots/**"   # repo-relative globs; ext:<service> for integrations; . for workspace
-updated: 2026-08             # month granularity only
----
-```
-
-Body — only non-empty sections, in this order:
-
-- `## Facts` — what IS: structure, behavior, topology. 1–3 lines each.
-- `## Invariants` — what MUST HOLD; optionally "broke when violated: <symptom>".
-- `## Gotchas` — symptom → cause → counter-move, ≤ 3 lines each.
-- `## Pointers` — key files, promoted-skill pointer lines, `External docs` (URL + gist).
-- `## Status` — optional; in-flight state only; every line dated; prune resolved lines on every read.
-
-`Status` is the **only** place dates and unfinished-work notes are allowed. Link related nodes
-inline with `[[node]]`.
-
-## Read protocol
-
-- **Session start**: read `.agents/memory/MEMORY.md` — the index only.
-- **Before a non-trivial task**: open every node whose scope matches the task (typically 1–3).
-- **When a topic surfaces mid-session** that the index names: open its node before acting.
-- **Never bulk-read** the store — the index + scopes exist so you don't have to.
-
-## Write protocol (compact-on-write)
-
-Every write is a merge, never an append:
-
-1. **Extract** — reduce the outcome to reusable knowledge atoms (rule below). Nothing survives →
-   write nothing.
-2. **Locate** — match scopes to find the node; none matches → create one per the naming rule and
-   add its index line.
-3. **Merge / supersede** — place each atom in the right section; if it refines or contradicts an
-   existing line, **rewrite that line in place** — never append a dated correction. The node
-   always reads as current truth.
-4. **Compact** — reread the node; collapse redundancy; delete anything the code or git history
-   now states; prune resolved `Status` lines.
-5. **Cap** — over soft cap: compact harder. Over hard cap: split by sub-scope into a linked child
-   node, or promote procedure-shaped overflow
-   (`.github/instructions/memory-promotion.instructions.md`, else the skill-authoring guidance).
-6. **Index** — update the hook line if the node's center of gravity moved; bump `updated:`.
-
-## Knowledge, not events
-
-**Record the rule, not the story.** For every line ask: *what must a future agent know to act
-correctly, stated without reference to this session?* Keep invariants, cause→effect,
-counter-moves, recognition fingerprints (symptoms). Drop dates, phase numbers, who did what,
-attempt sequences, and anything recoverable from code or git.
-
-Before (event log): "Verification 2026-06-11 … Bug found: script missing embedded-count logic.
-Fix deployed to all copies; second run idempotent."
-After (knowledge): "`nested-agent-context.sh` exists as byte-identical copies in the archive and
-each repo — fan every fix out to all copies; verify with `diff`. Correct re-runs are no-ops."
-
-## Size caps (hard)
-
-| Thing | Cap |
-|---|---|
-| Index entry | 1 line, hook ≤ 100 chars |
-| `MEMORY.md` | ≤ 50 lines |
-| Node file (soft / hard) | 80 / 120 lines |
-| Single fact/gotcha | ≤ 3 lines |
-| `Status` section | ≤ 5 dated lines |
-| Nodes per store (soft) | ~25 — merge low-traffic siblings beyond |
-
-## Memory vs instruction
-
-Fact-shaped ("what is true") stays here. Procedure-shaped ("to do X, do Y") becomes an
-instruction/skill — follow `.github/instructions/memory-promotion.instructions.md` where present,
-otherwise the skill-authoring guidance. Repeated use of a node to *perform* tasks, and over-cap
-nodes full of steps, are promotion triggers.
-
-Promotion is a **rewrite, never a move**: never paste node text into an instruction. "Record the
-rule, not the story" and the size caps above bind instruction bodies at least as tightly as they
-bind nodes (memory-promotion instruction → Distillation).

package/agent-meta/instructions/getting-started.instructions.md

@@ -1,62 +0,0 @@
----
-description: "How to build a fullstack OwlMeans Common app — the common/api/web three-workspace pattern, server and web context bootstrap, shared entrypoints + elevate(), and a session-scoped in-memory resource via @owlmeans/static-resource. Apply when starting a new OwlMeans project or wiring web↔api."
-applyTo: "**/modules.ts, **/context.ts, **/config.ts, **/render.tsx, **/index.tsx, **/sources/**"
-scope: general
----
-<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
-
-# Building a fullstack OwlMeans Common app
-
-A minimal app is a **bun-workspace monorepo with three packages**:
-
-- `sources/common` — shared **entrypoints** (routes), AJV schemas, types and config. The single
-  source of truth.
-- `sources/api` — `@owlmeans/server-app` backend; handlers attached to the shared entrypoints.
-- `sources/web` — `@owlmeans/web-panel` + shadcn UI; screens attached to the same entrypoints.
-
-Full walkthrough: `docs/getting-started.md`. To generate it: `npm create @owlmeans/app`.
-
-## One contract, two sides
-
-Declare each route once in `common`, then `elevate()` it on both sides:
-
-```ts
-// common/modules.ts
-export const sessionModules = [
-  entrypoint(route(session.list, '/:sid/items', { parent: session.base, method: RouteMethod.GET }),
-    filter(params(SessionParamsSchema))),
-]
-// api/modules.ts   → elevate(sessionModules, session.list, handlers.list)
-// web/modules.ts   → elevate(modules, session.list)  // call-only; screens via handler(Component)
-```
-
-## Config
-
-`common/config.ts` registers both services; `base: 'api'` prefixes API routes with `/api`:
-
-```ts
-const cfg = service({ type: AppType.Frontend, service: APP_WEB, host: 'localhost', port: 3001 })
-service({ type: AppType.Backend, service: APP_API, host: 'localhost', port: 3000, base: 'api' }, cfg)
-```
-
-## Backend + in-memory data
-
-```ts
-const context = makeContext(cfg, true)
-appendStaticResource(context, SESSION_ITEMS)   // @owlmeans/static-resource — no DB
-```
-
-Handlers (`handleRequest`/`handleBody`/`handleParams`) use `ctx.getStaticResource<T>(alias)`.
-`static-resource.list()` accepts no criteria — list all and filter in JS. `main(context, appModules)`
-starts the server. Swap for `@owlmeans/mongo-resource` / `redis-resource` when you need persistence.
-
-## Web (shadcn)
-
-`web-panel`'s `PanelApp` is shadcn/Tailwind v4. The app **provides** `@/lib/utils` and
-`@/components/ui/{alert,button,card,input,label,progress}` at the `@` alias (→ `src`). Render with
-`provide` from `@owlmeans/web-client`: `basicRender(<PanelApp context={context} provide={provide} />)`.
-A parent `BASE` route renders the layout via `handler(Layout)`; `HOME` is its default child. Screens
-call the API with `context.entrypoint(alias).call({ params, body })`.
-
-This shape is auth-free by design; add `@owlmeans/server-auth` + `@owlmeans/client-auth` and
-`guard(...)` when needed.

package/agent-meta/instructions/git.instructions.md

@@ -1,52 +0,0 @@
----
-description: "Mandatory git rules — never run state-changing git without explicit instruction, commit only under the user's configured identity (never as the AI/agent, no Co-Authored-By trailer), report finished git work as a Markdown table, and never commit a conflicted working copy. Consult before any git operation."
-applyTo: "**"
-scope: general
----
-<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
-
-# Git Workflow Rules
-
-**Mandatory and universal.** These rules apply to every git operation in this repository and
-**override any default agent behavior** — including any automatic `Co-Authored-By` or
-AI/agent-attribution trailer. Consult them before running any git command.
-
-## 0. Never run state-changing git without explicit instruction
-
-- **Never run state-changing git operations** (`commit`, `add`/`rm` staging, `push`,
-  `reset`/rollback, `revert`, `rebase`, `merge`, `branch`, `checkout`/`switch`, `stash`,
-  `tag`, `cherry-pick`, force-push, etc.) unless the user **explicitly instructs it in the
-  current request**. Permission to make code edits is **not** permission to touch git.
-- **Only exception**: creating and operating inside a **temporary git worktree** that a task
-  or subagent has **explicitly requested** for that purpose. Outside such an explicitly
-  requested tmp worktree, do nothing with git.
-- **Read-only inspection is allowed**: `git status`, `git diff`, `git log`, `git show`,
-  `git branch --list`, etc. — use these to report state, never to change it.
-
-## 1. Never commit under the agent's identity
-
-- Commit only under the repository's preconfigured git identity — whatever `git config user.name`
-  and `git config user.email` resolve to (set by the user, globally or locally).
-- **Never** override authorship: do not pass `--author`, do not set or change `user.name` /
-  `user.email`, and never substitute an AI / agent / assistant name or email.
-- **Never** add a `Co-Authored-By:` trailer (or any other trailer) attributing the commit to
-  Claude, Copilot, or any AI/agent. Every commit is the user's, attributed solely to the user.
-- If the repository has no git identity configured (neither local nor global), stop and ask the
-  user — do not invent one.
-
-## 2. Always report finished git work as a table
-
-- After completing any git action (commit, push, branch, checkout, merge, rebase, stash, tag,
-  reset, etc.), summarize what was done as a Markdown table.
-- One row per action. Include at least **Action**, **Target** (branch / remote / files / ref),
-  and **Result** (commit SHA, `pushed`, `up to date`, `conflict`, …). Add a **Notes** column
-  when useful.
-
-## 3. Never commit a conflicted working copy
-
-- If a `merge`, `rebase`, `cherry-pick`, `stash pop`/`apply`, or `pull` produces conflicts,
-  **do not** finalize it: do not run `git commit`, `git merge --continue`,
-  `git rebase --continue`, or stage-and-commit the conflicted tree to "resolve" it on the
-  user's behalf.
-- Stop, list the conflicted paths in the report table, and hand control back to the user —
-  unless the user has explicitly told you how to resolve the conflict and commit.