owfadev 0.0.1 → 0.3.1

package/.meta/plugins/core/log/PLUGIN.yaml

@@ -0,0 +1,18 @@
+id: log
+schema_version: 1
+version: 0.15
+bridge: 必依
+depends:
+  - wiki
+updated: 2026-10-06
+attachment:
+  - "wiki/log.md — single-file operation journal (rolling window)"
+  - "wiki/archive/YYYY-MM/log.md — archive spillover (immutable zone, grouped by entry month)"
+  - "scripts/check.py — attached audit (entry date contract)"
+fields: {}
+inject: "Run log `wiki/log.md`: new entries prepended at the top, entries never rewritten; entry = date + type (map/save/query/check/plugin/todo/profile/other) + [domain] (omissible — domainless transactions; log is a mandatory bridge: domain bases must depend on this plugin, constitution principle 11) + one sentence; window ≤100 entries, overflow is mechanically archived to `wiki/archive/<month>/log.md`"
+usage:
+  - Writing lines (mechanical, automatic): `python .meta/scripts/pipeline.py log <type> "<one sentence>" [--domain <domain>]` (type value set in the log block of the AGENTS injection region; domain tag = domain-plugin name such as bb/lark/vault, mandatory for in-domain transactions, omitted for framework and native transactions); rolling window and archiving are performed by the script
+checks:
+  - Mechanical items (attached-audit script `scripts/check.py`, executed on audit discovery): undated entries (starting with `- ` yet not matching the date format, main file and archive checked alike) → error
+  - Semantic items (check command): historical entries modified (verifiable via git) → error; capacity over the limit → re-check after mechanical archiving

package/.meta/plugins/core/log/scripts/check.py

@@ -0,0 +1,21 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""log plugin attached audit: mechanical items (entry date contract).
+
+Auditing modification of historical entries relies on git traces (semantic item, under the check command); capacity archiving is converged by the write pipeline.
+"""
+import re
+
+DATE_RE = re.compile(r"^- \d{4}-\d{2}-\d{2} ")
+
+
+def check(ctx):
+    issues = []
+    for rel, _fm, body in ctx.pages:
+        if rel != "log.md" and not (rel.startswith("archive/") and rel.endswith("/log.md")):
+            continue
+        for i, raw in enumerate(body.splitlines(), 1):
+            line = raw.rstrip()
+            if line.startswith("- ") and not DATE_RE.match(line):
+                issues.append({"level": "error", "message": f"{rel}:{i}: entry missing date ({line[:40]}…)"})
+    return issues

package/.meta/plugins/core/mapping/PLUGIN.md

@@ -0,0 +1,32 @@
+# mapping: vault Domain Mapping Rules
+
+## Design Summary
+
+- **Why it exists**: the mapping rules of the vault domain — maps every file in `vault/` to a proxy page in `wiki/vault/`, executed by the map command; projections of arbitrary-format assets take the 1:1 mirror density, the densest end of projection density, see Section 8 of mechanics. A proxy is the asset's representative in the md world: registration plus a one-line description to start, summaries are optional enhancements
+- **Key rulings**:
+  - 1:1 mirror with zero exceptions: md files also get proxies, preventing confusion between wiki-native and proxy; proxy name = original name plus .md, preventing name collisions
+  - The hash is a mismatch detector, not an enforcer: disposition of original changes goes through check triage, and triage writes a log line when done — mapping does not adjudicate
+  - Proxy pages belong to the regenerable zone: precious content goes into notes, not proxy pages; the body never copies the full original text — a proxy is not a copy
+
+## Structure
+
+- `wiki/vault/**` and `vault/**` in a one-to-one mirror: paths isomorphic; proxy file name = the original file's full name plus `.md` — e.g. `a.pdf` corresponds to `a.pdf.md`, preventing name collisions
+- md files also get proxies, no exceptions
+
+## Invariants
+
+- The path is the origin proof: pages under `wiki/vault/` always have a vault counterpart; the origin-dichotomy concept belongs to the wiki plugin. Reserved name `index.md` exemption — directory indexes belong to the navigation layer, not concept pages; having no vault counterpart does not count as an orphan proxy
+- The registration fields raw_file and raw_sha256 are mechanically recomputable from vault
+- Proxy pages belong to the regenerable zone: pipelines may rerun and overwrite; precious content is written into notes, not kept in proxy pages
+- A proxy body must not copy the full original text
+
+## Changelog
+
+- 0.8 2026-09-22: domain-ization — the first paragraph renamed from "bridge plugin" to "vault domain mapping rules", zero change in semantics and mechanism, positioning set right; depends keeps the two ends vault and wiki
+- 0.7 2026-09-14: vault governance batch — orphan-proxy messages gained reference counts, see the impact surface before deleting; triage writes a log line right after recalculation, leaving an audit trail of changes — under the snapshot model, mismatch facts used to vanish silently; usage gained the url registration contract, the write side of vault source preservation
+- 0.6 2026-09-13: attached audit gained the hard check for missing registration fields — expert review: the injection region said always-present while the attached audit silently skipped
+- 0.5 2026-09-13: usage absorbed the diary-type exemption — moved in from the map command's prohibitions, removing the body echo
+- 0.4 2026-09-13: injection source moved to the manifest — removed Fields, Checks, Usage, Inject, Attachments sections, md returned to pure documentation
+- 0.3 2026-09-13: established the "Usage" section — the write-side contract is projected by the command's injection region, a single text source
+- 0.2 2026-09-12: command ingest renamed map and slimmed — the polishing questions removed, pure registration; vault governance discussed separately
+- 0.1 2026-09-12: renamed and established from the vault plugin, version restarted, old history in git — semantically depends on vault and wiki; the clause "commands are append-only toward vault, freedom to delete and modify belongs to the human" moved to the vault concept plugin's injection line; the origin-dichotomy concept moved to the wiki plugin

package/.meta/plugins/core/mapping/PLUGIN.yaml

@@ -0,0 +1,24 @@
+id: mapping
+schema_version: 1
+version: 0.8
+depends:
+  - vault
+  - wiki
+updated: 2026-10-06
+attachment:
+  - "wiki/vault/ — proxy-layer directory, one-to-one mirror of the root vault/"
+  - "scripts/check.py — attached audit (mirror diff / hash verification / full-text duplication / stub aging)"
+fields:
+  raw_file: "root-relative path, always present on proxy pages"
+  raw_sha256: "hexadecimal SHA-256, mechanically recomputable from vault"
+commands:
+  - map
+inject: "Proxy layer `wiki/vault/`: 1:1 mirror of root `vault/` (proxy name = original name + .md), pages always carry raw_file / raw_sha256; the path is the origin proof"
+usage:
+  - Mirror locating: proxy path = `wiki/vault/<original-path>.md` (original name + .md, prevents name collisions); md assets also get proxies, no exceptions
+  - Registration fields: `type: source` + `raw_file` (root-relative path) / `raw_sha256` (hexadecimal SHA-256, never skip the computation)
+  - Body starts with a one-line description, never copying the full original text; summary / structure extraction are optional enhancements; diary-type assets are registration-first, summaries not enforced
+  - URL-type assets: the proxy page carries `url` (vault field — source link, source preservation; required when placed via agent channels, optional for manual placement)
+checks:
+  - Mechanical items (attached-audit script `scripts/check.py`, executed on audit discovery): mirror diff (file in vault without proxy → info backlog; proxy without counterpart → error, message carries the reference count — see the impact surface before deleting); missing registration fields (raw_file / raw_sha256) → error; dangling raw_file → error; raw_sha256 mismatch → warning; suspected full-text duplication (md asset body ≥80% of the original) → warning; description-less stub with updated older than 90 days → warning
+  - Semantic items (check command): mismatch-disposition triage (description still applies → mechanical recalculation auto-repairs, writing a log line on completion (type map, one sentence with the asset name and 'original changed, description still applies'); suspected invalid → human decides remap or delete); diary-type full-text duplication exemption judgment; before disposing an orphan proxy, handle its references first (update references in sync or leave aliases to redirect)

package/.meta/plugins/core/mapping/scripts/check.py

@@ -0,0 +1,90 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""mapping plugin attached audit: mirror diff, registry-field completeness, raw_file dangling, hash verification, suspected full-text copies, stub aging.
+
+Read-only report — repair actions such as hash recalculation belong to the command (actions.md mechanical automatic items); the attached audit does not execute them.
+Parameter basis: forensic evidence from the original library (40% hash mismatch, 33% full-text copies) and the progressive-enrichment promise (new stubs exempt from alerts).
+"""
+import datetime
+import hashlib
+import os
+import re
+
+TODAY = datetime.date.today()
+
+
+def _file_set(root, sub, strip_md):
+    """Collect the file set under a subdirectory (ignore .gitkeep); when strip_md, collect md only and strip the suffix (proxy page set)."""
+    out = set()
+    base = os.path.join(root, sub)
+    for dirpath, dirs, files in os.walk(base):
+        dirs.sort()
+        for fn in sorted(files):
+            if fn == ".gitkeep":
+                continue
+            if strip_md and fn == "index.md":
+                continue  # directory index: navigation-layer reserved name (per-directory by the index plugin), not a concept page, no counterpart
+            if strip_md and not fn.endswith(".md"):
+                continue
+            rel = os.path.relpath(os.path.join(dirpath, fn), base).replace(os.sep, "/")
+            out.add(rel[:-3] if strip_md else rel)
+    return out
+
+
+def _ref_count(ctx, full):
+    """Count references across the whole library pointing to full (page full name): body wikilinks + related field."""
+    n = 0
+    pat = re.compile(r"\[\[([^\]\|#]+)")
+    for _rel, fm, body in ctx.pages:
+        for m in pat.finditer(str(body)):
+            if m.group(1).strip() == full:
+                n += 1
+        for r in (fm.get("related") or []):
+            if str(r).strip() == full:
+                n += 1
+    return n
+
+
+def check(ctx):
+    issues = []
+    root = ctx.root
+    real = _file_set(root, "vault", strip_md=False)
+    proxy = _file_set(root, os.path.join("wiki", "vault"), strip_md=True)
+    for f in sorted(real - proxy):
+        issues.append({"level": "info", "message": f"vault pending registration (backlog): {f}"})
+    for p in sorted(proxy - real):
+        refs = _ref_count(ctx, f"vault/{p}")
+        note = f", referenced from {refs} places" if refs else ", no references"
+        issues.append({"level": "error", "message": f"orphan proxy (no vault counterpart{note}): wiki/vault/{p}"})
+    for rel, fm, body in ctx.pages:
+        if not rel.startswith("vault/"):
+            continue
+        if os.path.basename(rel) == "index.md":
+            continue  # directory index: navigation-layer reserved name, not a proxy page
+        rf = fm.get("raw_file")
+        if not rf:
+            issues.append({"level": "error", "message": f"{rel}: missing registry field raw_file (mandatory on proxy pages)"})
+            continue
+        if not fm.get("raw_sha256"):
+            issues.append({"level": "error", "message": f"{rel}: missing registry field raw_sha256 (mandatory on proxy pages)"})
+        fp = os.path.join(root, rf)
+        if not os.path.exists(fp):
+            issues.append({"level": "error", "message": f"{rel}: raw_file points to a nonexistent file ({rf})"})
+            continue
+        sh = fm.get("raw_sha256")
+        if sh and hashlib.sha256(open(fp, "rb").read()).hexdigest() != sh:
+            issues.append({"level": "warning", "message": f"{rel}: raw_sha256 mismatch (source file changed; if the description still applies, recalculate mechanically)"})
+        if rf.endswith(".md"):
+            try:
+                raw_text = open(fp, encoding="utf-8").read()
+            except UnicodeDecodeError:
+                raw_text = open(fp, encoding="utf-8", errors="replace").read()
+            if raw_text and len(body) >= 0.8 * len(raw_text):
+                issues.append({"level": "warning", "message": f"{rel}: suspected full-text copy (body ≥80% of the source; diary-type exemption is a semantic judgment)"})
+        if not body.strip():  # stub: body has no one-line description
+            m = re.fullmatch(r"(\d{4})-(\d{2})-(\d{2})", str(fm.get("updated") or ""))
+            if m:
+                age = (TODAY - datetime.date(*map(int, m.groups()))).days
+                if age > 90:
+                    issues.append({"level": "warning", "message": f"{rel}: stub over 90 days without a description (new stubs exempt)"})
+    return issues

package/.meta/plugins/core/notes/PLUGIN.md

@@ -0,0 +1,42 @@
+# notes: native notes
+
+## Design Overview
+
+- **Why it exists**: knowledge whose provenance is the wiki itself — the 'original text' is the wiki, with no counterpart in vault. The main territory of native knowledge; session minutes and profile cognition are routed by closed type values to their own territories
+- **Key rulings**:
+  - No-regeneration zone: pipelines and commands must not overwrite or rewrite existing notes; they may only add, and humans may edit freely — the true copy lives here, writing is birth
+  - Subdivision relies on the type field, not directories: form values are open, default vocabulary in registry, self-extended by instances — the architecture takes no responsibility for form classification. The 0.13 ruling: the 'concept/question/decision/entity' enumeration was a residue of the personal-library migration and had drifted from registry
+  - The boundary with the proxy layer is proven by path: wiki/vault/ always has a counterpart, wiki/notes/ never does — the path is the provenance
+
+## Structure
+
+- `wiki/notes/**`; file names free, named by humans, in contrast to the mechanical naming of the mirror zone
+- Subdivision via the type field, not directories; form values open, default vocabulary in registry, self-extended by instances; territory values session and profile are closed and must land in their own territories
+
+## Invariants
+
+- No-regeneration zone: pipelines and commands must not overwrite or rewrite existing notes; only additions or manual human edits
+- The boundary with the vault proxy layer is proven by path: wiki/vault/ always has a counterpart, wiki/notes/ never does
+- The boundary with sessions and user-profile is proven by type: type: session lands in `wiki/sessions/`; type: profile lands in `wiki/profile.md`; neither lands in this zone
+
+## Bridge: on-demand
+
+A derivation-destination bridge governing high-value conclusions: domain plugins one-way derive high-value conclusions that emerge as native notes, with a required back-link to the source page. Constitutional principle 11. Attachment cardinality **on-demand**. Format authority is in this plugin's usage, projected to the point of consumption — division-of-labor ruling. This section elaborates: the type is freely chosen within the form vocabulary, the body back-links via wikilink; the domain plugin keeps a one-sentence self-description disclosure, SASU-L.
+
+## Changelog
+
+- 0.15 2026-10-02: global-domain batch two — established the on-demand bridge as the derivation destination; domain-plugin self-descriptions retained with a pointer
+- 0.14 2026-09-23: added the wiki dependency edge — inner plugins attach to wiki, aligning with the domain 0.1 declaration; missed in the 2026-09-22 domainization batch
+- 0.13 2026-09-14: slimmed down; ruling: the architecture takes no responsibility for form classification — the form enumeration removed from body and inject line; 'concept/question/decision/entity' was personal-library migration residue, drifted from registry, comparison missed; type layering: territory values closed, namely source, session, profile — the basis for mechanical checks; form values demoted to an instance default vocabulary, registry defaults, open to self-extension
+- 0.12 2026-09-13: usage updated for semantic stitching — update = append-style merge under user instruction leaving a trace, or manual edits; expert review: two tellings alongside the save dedup section
+- 0.11 2026-09-13: usage dropped the type enumeration; the value set's single source is registry, removing triple restatement
+- 0.10 2026-09-13: inject source moved to the manifest — deleted the Checks, Usage, Inject, Attachments sections; md returns to pure documentation
+- 0.9 2026-09-13: established the Usage section — write-side contracts handed to command injection regions for projection, single text source
+- 0.8 2026-09-12: manifest dropped layer — layering abolished: injection order changed to dependency topology plus alphabetical, direction checks removed
+- 0.7 2026-09-12: identifiers anglicized — section headers, attached-audit contract keys, type enumerations, pipeline call parameters
+- 0.6 2026-09-11: manifest added commands: [save] — save is jointly driven by this plugin and sessions
+- 0.5 2026-09-10: narrowed scope — session backbone pages moved to the sessions plugin, an independent territory `wiki/sessions/`; this zone kept concept, question, decision, entity
+- 0.4 2026-09-10: type enumeration wording fixed — defers to the registry value set, resolving the contradiction with registry closure
+- 0.3 2026-09-10: manifest added layer: origin — layering established: the provenance layer, zero dependencies
+- 0.2 2026-09-09: orphan checks moved to the link plugin — graph properties belong to the link layer
+- 0.1 2026-09-08: merged and simplified from the original wiki concepts, questions, comparisons, and sessions zones; subdivision batch two

package/.meta/plugins/core/notes/PLUGIN.yaml

@@ -0,0 +1,19 @@
+id: notes
+schema_version: 1
+version: 0.15
+bridge: 按需
+depends:
+  - wiki
+updated: 2026-10-06
+attachment:
+  - "wiki/notes/ — native notes zone"
+fields: {}
+commands:
+  - save
+inject: "Native notes `wiki/notes/`: knowledge whose provenance is the wiki itself, subdivided by the type field (open form vocabulary, default values in registry); no-regeneration zone, commands append-only and never modify; session and profile types do not land in this zone (they belong to the sessions / user-profile territories); notes on-demand bridge — domain plugins one-way derive high-value conclusions into this zone on an emergence basis, and must back-link the source page (constitutional principle 11, format owned by this bridge)"
+usage:
+  - Landing spot `wiki/notes/<title>.md`, file name free (named by humans); type form vocabulary in registry (open, self-extended by instances), territory values do not land in this zone
+  - Append-only: commands never rewrite an existing note wholesale; updating = append-style merge under user instruction (trace left in the body) or manual human edits
+checks:
+  - Traces of a note overwritten by a command → error
+  - Near-duplicate notes (Jaccard > 0.7) → warning

package/.meta/plugins/core/sessions/PLUGIN.md

@@ -0,0 +1,63 @@
+# sessions: native sessions
+
+## Design Overview
+
+- **Why it exists**: the backbone structure for session distillation — the knowledge of one collaboration session is archived as a backbone page, high-value topics promoted to standalone notes. In the original wiki vision sessions were a first-class zone; when merged into notes on 2026-09-08 they were demoted to a type, with the structure lodged in the save command; once this plugin was established the structure returned home and the command went back to pure operation — an example of separating territory and command responsibilities
+- **Key rulings**:
+  - Session pages are minutes, not mirrors: once the conversation fades the page is the true copy, writing is birth — a specimen of wiki provenance determination
+  - participants required, using the actor convention: recorded even for a single agent; multi-agent collaboration extends the list directly — reserved for the collaborative state
+  - Promotion rule: standalone high-value topics rise to notes pages, whose provenance is knowledge rather than session record; the backbone page keeps a wikilink — distillates belong to notes
+  - No-regeneration zone: append-only, never modified
+
+## Structure
+
+- `wiki/sessions/**`; default naming `YYYY-MM-DD-<topic>.md`
+- type: session, value set in registry; participants required: YAML list, the actor convention being human:name, process:flow name, agent/model id — recorded even for a single agent; multi-agent collaboration extends this list directly
+- Backbone page shape: Core Conclusions; Decisions & Rationale; Non-obvious Insights; Open Questions; Related Pages — promoted topics attached via wikilink
+- Promotion rule: standalone high-value topics promoted to `wiki/notes/` pages, whose provenance is knowledge rather than session record; the backbone page keeps a wikilink
+
+## Example
+
+`wiki/sessions/2026-09-12-fog-harbor-art-style-finalized.md`:
+
+```markdown
+---
+type: session
+title: Fog Harbor art style finalized
+participants: [human:Joss, agent/GLM-5.3]
+created: 2026-09-12
+tags: [game/art]
+---
+# Core Conclusions
+Low-poly plus volumetric fog finalized; moving on to scene art outsourcing inquiries.
+
+# Decisions & Rationale
+Pixel art rejected: poor silhouette readability. See [[notes/fog-harbor-art-style-decision]].
+
+# Non-obvious Insights
+The budget-overrun risk concentrates in scene art outsourcing (quoted 168k, 40% over budget).
+
+# Open Questions
+The performance budget for volumetric fog on low-end machines?
+
+# Related Pages
+- [[notes/fog-harbor-art-style-decision]] (the decision page promoted out of this session)
+```
+
+## Invariants
+
+- No-regeneration zone: pipelines and commands append-only, never modify
+- Territory boundary complementary with notes: type: session must land in `wiki/sessions/`; all other native notes land in `wiki/notes/`
+- Promoted pages belong to the notes territory; this plugin owns only backbone pages
+
+## Changelog
+
+- 0.9 2026-09-23: added the wiki dependency edge — inner plugins attach to wiki, aligning with the domain 0.1 declaration; missed in the 2026-09-22 domainization batch
+- 0.8 2026-09-13: made the usage sample pointer explicit — added the `.meta/plugins/sessions/PLUGIN.md` path, zero priors
+- 0.7 2026-09-13: inject source moved to the manifest — deleted the Checks, Usage, Inject, Attachments sections; md returns to pure documentation
+- 0.6 2026-09-13: established the Usage section — write-side contracts handed to command injection regions for projection, single text source
+- 0.5 2026-09-12: manifest dropped layer — layering abolished: injection order changed to dependency topology plus alphabetical, direction checks removed
+- 0.4 2026-09-12: identifiers anglicized — section headers, attached-audit contract keys, type enumerations, pipeline call parameters
+- 0.3 2026-09-12: disclosure repair — inlined the full-shape backbone page sample; a cold-start audit guess point: no instances in the zone
+- 0.2 2026-09-11: manifest added commands: [save] — save is jointly driven by this plugin and notes
+- 0.1 2026-09-10: established — extracted from the save command's long-session segment and the merged notes zone, a return of the 2026-09-08 'subdivision batch two'; territory `wiki/sessions/`; participants uses the actor convention, reserving a multi-agent extension point

package/.meta/plugins/core/sessions/PLUGIN.yaml

@@ -0,0 +1,20 @@
+id: sessions
+schema_version: 1
+version: 0.9
+depends:
+  - wiki
+updated: 2026-10-06
+attachment:
+  - "wiki/sessions/ — native sessions zone, session-type backbone pages"
+fields:
+  participants: "YAML list, actor convention (human:name / process:flow name / agent/model id), the multi-agent collaboration extension point"
+commands:
+  - save
+inject: "Native sessions `wiki/sessions/`: session backbone pages (type: session, participants required = actor list, default naming YYYY-MM-DD-<topic>); high-value topics promoted to standalone `wiki/notes/` pages with a back-link; no-regeneration zone, commands append-only and never modify"
+usage:
+  - Landing spot `wiki/sessions/YYYY-MM-DD-<topic>.md` (default naming), type: session, participants required (actor list)
+  - Backbone page five-section shape: Core Conclusions / Decisions & Rationale / Non-obvious Insights / Open Questions / Related Pages (full-shape sample in the Example section of `.meta/plugins/sessions/PLUGIN.md`)
+  - Standalone high-value topics promoted to `wiki/notes/` pages, the backbone page keeping a wikilink; dedupe before promotion
+checks:
+  - Mechanical (covered by audit): session-type pages outside `wiki/sessions/` (or the reverse) → warning; participants missing or entries violating the actor convention → warning
+  - Semantic: backbone page bloated past due promotion (should have been promoted but was not) → warning

package/.meta/plugins/core/sessions/scripts/check.py

@@ -0,0 +1,33 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""sessions plugin attached audit: mechanical items (territory boundary / participants contract).
+
+Whether a backbone page should have been promoted but was not is a semantic item (bloat judgment), under the check command.
+"""
+import re
+
+ACTOR_RE = re.compile(r"^(human:.+|process:.+|agent/.+)$")
+
+
+def check(ctx):
+    issues = []
+    for rel, fm, body in ctx.pages:
+        if rel.endswith("/index.md") or rel == "index.md":
+            continue  # derived pages are not backbone pages and take no part in territory determination
+        ptype = fm.get("type")
+        in_sessions = rel.startswith("sessions/")
+        if ptype == "session" and not in_sessions:
+            issues.append({"level": "warning", "message": f"{rel}: session-type page should live under wiki/sessions/ (sessions plugin territory)"})
+        elif in_sessions and ptype != "session":
+            issues.append({"level": "warning", "message": f"{rel}: pages under wiki/sessions/ should be type: session (actually {ptype or 'untyped'})"})
+        if ptype == "session" or in_sessions:
+            parts = fm.get("participants")
+            if parts is None:
+                issues.append({"level": "warning", "message": f"{rel}: missing participants (actor list)"})
+            else:
+                if not isinstance(parts, list):
+                    parts = [parts]
+                for p in parts:
+                    if not ACTOR_RE.match(str(p)):
+                        issues.append({"level": "warning", "message": f"{rel}: participants item {p!r} does not match the actor convention (human:name / process:name / agent/model)"})
+    return issues

package/.meta/plugins/core/structure/PLUGIN.md

@@ -0,0 +1,29 @@
+# structure: vault Layout
+
+## Design Summary
+
+- **Why it exists**: vault presets no structure, but a total absence of structure means fast-growing entropy — user-write manuscript 2026-09-07. This plugin sets the layout rules: structure is declared by the instance, the framework provides a preset menu, placement rules, and drift detection. Another instance of skeleton/instance separation; the vault side is henceforth symmetric with the wiki side: the concept plugin governs "what it is", the structure plugin governs "how it is organized"
+- **Key rulings**:
+  - Declaration page machine-readable plus a human-readable body: the frontmatter `structure` block mapping holds the declaration proper, the body holds preset notes; page absent = flat tolerance, a legal state — structure is an optional enhancement, not a requirement
+  - vault belongs to the human: structural adjustment is free; the agent only places and reminds, never coerces. The declaration is intent, the diff is a drift reminder, disposition always belongs to the human
+  - The two-way diff is mechanically decidable, done by the attached audit: constraining only top-level directories; loose top-level files are the flat slot
+  - Governance pages inside wiki, governance targets outside in vault — the same-shaped general rule of the domain contract
+
+## Structure
+
+- `wiki/structure.md` — the structure declaration page, type: structure. The frontmatter `structure` block mapping holds the declaration proper — top-level directory to one-line semantics, machine-readable; the body holds preset choices and notes, for humans; page absent = flat tolerance, a legal state
+- Preset menu: date — `xxxx-xx-xx` daily folders; format — `pdf/`, `md/`; type — semantic categories such as diary, clippings; mixed — nesting without mutual exclusion
+- The shell's natural-language declaration retired: inside wiki is the only retrieval-reachable zone for agents; the shell keeps a pointer to the declaration page
+
+## Invariants
+
+- Structural choice is instance configuration, not architecture. Touchstone: a concrete directory layout cannot be carried into a new instance
+- vault belongs to the human: structural adjustment is free; the agent only places and reminds, never coerces
+- The two-way diff between declaration and reality is mechanically decidable, via the attached-audit script; the declaration is intent, the diff is a drift reminder, disposition always belongs to the human
+- The diff constrains only top-level directories; loose top-level files are the flat slot, unconstrained by the declaration
+
+## Changelog
+
+- 0.3 2026-09-22: domain-ization — the first paragraph gained in-domain governance positioning, transitively belonging to the vault domain, governance page inside and target outside; depends unchanged, transitivity means membership
+- 0.2 2026-09-14: territory moved into wiki — declaration page `wiki/structure.md`, frontmatter structure block mapping machine-readable; drift detection upgraded from a semantic item to the attached-audit script, i.e. the declaration diff; depends gained wiki; the shell's natural-language declaration retired
+- 0.1 2026-09-14: established — from the user-write manuscript, i.e. the four presets plus the AGENTS declaration, distilled with the vault governance discussion; the layout responsibility separated from the vault concept plugin, symmetric to the wiki side's concept-and-structure layering

package/.meta/plugins/core/structure/PLUGIN.yaml

@@ -0,0 +1,18 @@
+id: structure
+schema_version: 1
+version: 0.3
+depends:
+  - vault
+  - wiki
+updated: 2026-10-06
+attachment:
+  - "wiki/structure.md — structure declaration page (the vault layout declaration proper: frontmatter structure block mapping + body preset notes)"
+  - "scripts/check.py — attached audit (declaration diff / territory placement / declaration-page existence)"
+fields: {}
+inject: "vault structure declaration `wiki/structure.md` (type: structure): frontmatter `structure` block mapping = directory → one-line semantics, body records presets (date/format/type/mixed, nestable) and notes; agents read this page before placing assets, placing them by position; page absent = flat tolerance; after the human adjusts vault, sync the declaration, check does a mechanical diff (undeclared top-level directory / declared-but-nonexistent directory → warning)"
+usage:
+  - How to declare: frontmatter `structure` block mapping (key = top-level directory name with trailing slash, value = one-line semantics); the body records preset choices and nesting-rule notes
+  - Agent placing assets into vault: read the declaration page first and place by position; with no fitting position, use the flat slot or create a directory then supplement the declaration; if the page is absent, place flat in the root directory
+  - The human adjusts structure freely (vault belongs to the human); after adjusting, sync the declaration; drift is flagged mechanically by the attached audit
+checks:
+  - Mechanical items (attached-audit script `scripts/check.py`, executed on audit discovery): declaration diff — vault top-level directory undeclared → warning, declaration key pointing to a nonexistent directory → warning; type: structure landing outside `wiki/structure.md` → error; declaration page absent → info (flat tolerance)

package/.meta/plugins/core/structure/scripts/check.py

@@ -0,0 +1,32 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""structure plugin attached audit: structure declaration page existence, diff between declarations and vault's actual top-level directories, territory misplacement.
+
+A missing declaration page = flat-layout tolerance (legal, info); the diff covers top-level directories only — loose top-level files are flat slots, unconstrained.
+"""
+import os
+
+
+def check(ctx):
+    issues = []
+    # territory misplacement: type: structure is allowed only at wiki/structure.md
+    decl = None
+    for rel, fm, _body in ctx.pages:
+        if fm.get("type") == "structure" and rel != "structure.md":
+            issues.append({"level": "error", "message": f"{rel}: type: structure outside the declaration page (territory misplacement)"})
+        if rel == "structure.md":
+            decl = fm.get("structure") or {}
+    if decl is None:
+        issues.append({"level": "info", "message": "no structure declaration page (flat-layout tolerance)"})
+        return issues
+    vroot = os.path.join(ctx.root, "vault")
+    if not os.path.isdir(vroot):
+        return issues
+    actual = {d + "/" for d in os.listdir(vroot)
+              if os.path.isdir(os.path.join(vroot, d)) and not d.startswith(".")}
+    declared = {str(k).strip() for k in decl}
+    for d in sorted(actual - declared):
+        issues.append({"level": "warning", "message": f"vault top-level directory undeclared: {d} (add a declaration or put it in place)"})
+    for d in sorted(declared - actual):
+        issues.append({"level": "warning", "message": f"declaration points to a nonexistent directory: {d} (declaration outdated; sync or delete)"})
+    return issues

package/.meta/plugins/core/tag/PLUGIN.md

@@ -0,0 +1,37 @@
+# tag: Semantic Classification
+
+## Design Summary
+
+- **Why it exists**: semantic classification across all pages — a semantic index with zero infrastructure: the semantic work is done at write time, map and save tag along the way; retrieval only does mechanical matching
+- **Key rulings**:
+  - Division of labor between type and tags: type is a closed protocol enum, origin, for machines to read; tags are open semantic classification, for humans and agents to retrieve — the two axes never mix, restating type is forbidden
+  - The vocabulary grows freely, governance is after-the-fact merging, no up-front control — consistent with "the architecture does not enumerate"
+  - Lightweight discipline: the primary language follows the language page's default key (absent → session language, preventing mixed Chinese-English fragmentation of the vocabulary); English proper names in kebab-case; hierarchy `/`-separated up to two levels; at most 5 per page, a soft cap. The former "Chinese-primary" hardcoding was removed in the language-neutralization batch (2026-10-04) — Chinese was merely a development-phase instance fact of this project
+
+## Structure
+
+Owns the `tags` field conventions:
+
+- YAML list; the primary language follows the language page's default key (absent → session language), English proper names keep their original form
+- English tags use lowercase kebab-case, e.g. local-llm
+- Hierarchy allows the `parent/child` form; depth at most 2
+- At most 5 per page, a soft cap
+
+## Invariants
+
+- `type` is a closed protocol enum, origin, for machines to read; `tags` are open semantic classification, for humans and agents to retrieve; restating type semantics is forbidden
+- The vocabulary grows freely; governance is after-the-fact merging, no up-front control
+
+## Changelog
+
+- 0.11 2026-10-04: language neutralization — "Chinese-primary" removed; the primary language follows the language page's default key (absent → session language); hierarchy wording changed to "≤2, `/` separated"; the English kebab-case word-shape rule kept (already neutral); same batch as the language v0.2 follow-up cleanup
+- 0.10 2026-09-23: added the wiki dependency edge — inner-side plugins attach to wiki, aligning with the domain 0.1 declaration; omitted from the 2026-09-22 domain-ization batch
+- 0.9 2026-09-13: checks merged with executors unified as mechanically-confirmed items; expert review: two conflicting tellings versus actions.md
+- 0.8 2026-09-13: injection source moved to the manifest — removed Checks, Usage, Inject, Attachments sections, md returned to pure documentation
+- 0.7 2026-09-13: established the "Usage" section — the write-side contract is projected by the command's injection region, a single text source
+- 0.6 2026-09-12: manifest dropped layer — layering abolished: injection order changed to dependency topology plus alphabetical order, direction checks removed
+- 0.5 2026-09-12: identifiers anglicized — section headers, attached-audit contract keys, type enums, pipeline call parameters
+- 0.4 2026-09-11: attached audit gained the hierarchy-depth check, parent/child at most 2, empty-segment warnings
+- 0.3 2026-09-10: manifest gained layer: field — layering established: field layer, zero dependencies
+- 0.2 2026-09-09: mechanical check items landed in the attached-audit script scripts/check.py; this file keeps the semantic items
+- 0.1 2026-09-08: newly established, absorbing the original lint's near-duplicate check idea

package/.meta/plugins/core/tag/PLUGIN.yaml

@@ -0,0 +1,18 @@
+id: tag
+schema_version: 1
+version: 0.11
+depends:
+  - wiki
+updated: 2026-10-06
+attachment:
+  - "Cross-cutting plugin: owns the frontmatter tags field across all pages plus vocabulary governance"
+  - "scripts/check.py — attached audit (>5 per page / restating type / hierarchy depth)"
+fields:
+  tags: "YAML list ≤5; primary language follows the language page's default key (absent → session language); English tags lowercase kebab-case; hierarchy ≤2, `/` separated; restating type forbidden"
+inject: "Page `tags` field: YAML list; primary language follows the default key of the writing-style declaration page `wiki/language.md` (page or key absent → session language); English tags lowercase kebab-case; hierarchy ≤2 (`/` separated), ≤5 per page; open semantic classification, restating type forbidden"
+usage:
+  - Before writing, read `wiki/tags.md` and prefer reusing existing terms
+  - New-term conventions: primary language follows the language page's default key (absent → session language, preventing mixed Chinese-English fragmentation of the vocabulary); English lowercase kebab-case; hierarchy ≤2; ≤5 per page; restating type forbidden
+checks:
+  - Mechanical items (attached-audit script `scripts/check.py`, executed on audit discovery): >5 tags on one page → warning; tags restating type → warning; hierarchy over the limit (parent/child ≤2) or empty segment → warning
+  - Semantic items (check command): near-duplicate tags → warning suggesting a merge; merging is a mechanically-confirmed item (list presented, executed after user confirmation)

package/.meta/plugins/core/tag/scripts/check.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""tag plugin attached audit: mechanical items (per-page count cap / restating type / hierarchy depth).
+
+Near-duplicate tags are a semantic item (cross-language synonyms are not decidable at the string level), under the check command.
+"""
+
+
+def check(ctx):
+    issues = []
+    for rel, fm, body in ctx.pages:
+        tags = fm.get("tags")
+        if tags is None:
+            continue
+        if not isinstance(tags, list):
+            tags = [tags]
+        if len(tags) > 5:
+            issues.append({"level": "warning", "message": f"{rel}: {len(tags)} tags (>5 soft cap)"})
+        ptype = fm.get("type")
+        if ptype and ptype in tags:
+            issues.append({"level": "warning", "message": f"{rel}: tag restates type ({ptype})"})
+        for t in tags:
+            s = str(t)
+            if "/" in s:
+                parts = s.split("/")
+                if len(parts) > 2 or any(not p.strip() for p in parts):
+                    issues.append({"level": "warning", "message": f"{rel}: tag hierarchy over limit or empty segment ({s}, parent/child ≤2)"})
+    return issues

package/.meta/plugins/core/tmp/PLUGIN.md

@@ -0,0 +1,26 @@
+# tmp: temporary zone
+
+## Design Overview
+
+- **Why it exists**: the wiki's /tmp — a legitimate home for drafts and parsing intermediates. All the framework's territories until now were formal: immutable, append-only, sources of truth; intermediate states had nowhere to go. This plugin fills the gap: failure allowed, incompleteness allowed
+- **Key rulings**:
+  - Invisible to the derived layer, treated like archive: absent from index and tags, never a link source, broken links exempt — [[a page not yet written]] in a draft is the normal state of 'not yet written down'; closure is required only upon promotion
+  - No retention promise, yet no automatic cleanup: cleanable at any time; disposal goes through confirmation — check reports the over-age list; promotion or deletion belongs to the human. Deletion belongs to the human, breaking nothing
+  - Delete the draft upon promotion: promote precious drafts promptly, via save into notes or merged into a project decision section; tmp hoards no treasures
+  - The path is the territory: everything under `wiki/tmp/**` is tmp
+
+## Structure
+
+- `wiki/tmp/**` — the path is the territory; everything below is tmp; type optional, `type: tmp` landing outside the territory → error
+- Flat layout tolerated, subdirectories free, no reserved-name constraints
+
+## Invariants
+
+- No retention promise, the /tmp contract: cleanable at any time; promote precious drafts promptly — via save into notes, merged into a project decision section, etc. — deleting the draft upon promotion
+- Cleanup is never automatic: parsing intermediates set `stale_after` as they go, check reports the over-age list, disposal goes through confirmation; drafts without stale_after are not flagged — deletion belongs to the human, breaking nothing
+- The invisibility triple: excluded from concept-page determination, unseen by index and tags; under link never a link source and exempt from graph checks; hot naturally uninvolved, being hand-written
+- Sensitivity reminder: parsing intermediates may contain personal data such as chat transcripts; instances may gitignore `wiki/tmp/`
+
+## Changelog
+
+- 0.3 (2026-10-06) inject line: code formatting restored on the territory path (issue #12 post-migration nit)- 0.2 (2026-10-06) inject line compressed to pointer density (issue #12 layer discipline) — procedural detail lives in usage / PLUGIN.md / skills- 0.1 2026-09-19: established — path-as-territory, invisible to the derived layer, stale_after cleanup prompts, delete upon promotion

package/.meta/plugins/core/tmp/PLUGIN.yaml

@@ -0,0 +1,16 @@
+id: tmp
+schema_version: 1
+version: 0.3
+depends:
+  - wiki
+updated: 2026-10-06
+attachment:
+  - "wiki/tmp/ — temporary zone (the path is the territory; instance data — real contents never enter the framework repo or test-repo)"
+fields: {}
+inject: "Temporary zone `wiki/tmp/` (the path is the territory; type: tmp optional, landing outside → error): drafts and parsing intermediates, no retention promise, cleanable any time; invisible to the derived layer — excluded from index/tags, never a link source, broken links exempt; promote precious drafts promptly (draft deleted on promotion); intermediates set stale_after as they go — check reports over-age, disposal via confirmation (no automatic deletion); sensitive intermediates best gitignored instance-side"
+usage:
+  - Drafts / parsing scratch: land directly at `wiki/tmp/<name>.md`, frontmatter kept simple (title + optional stale_after); broken links may stay as written
+  - Promotion: content distilled via save into notes or merged into the target territory (a project decision section, etc.); delete the draft after the links close (agent-created drafts deleted by the agent; human drafts upon confirmation)
+  - Cleanup: check reports the stale over-age list → delete after confirmation; long-unpromoted drafts go to the user for keep-or-drop adjudication
+checks:
+  - Semantic (v0.1 manual, attached audit deferred): type: tmp landing outside wiki/tmp/ → error; stale_after already past → warning (cleanup prompt); tmp page count > 20 → info (backlog triage)