skillwiki 0.8.10 → 0.9.1-beta.1

package/dist/cli.js

@@ -184,6 +184,7 @@ var endpointName = z.string().min(1).regex(/^[A-Za-z0-9_.-]+$/, "must be a hostn
 var ipAddress = z.string().min(1).regex(/^[0-9a-fA-F:.]+$/, "must be an IP address token");
 var sshAlias = z.string().min(1).regex(/^[A-Za-z0-9_.@-]+$/, "must be an SSH alias token");
 var sshUser = z.string().min(1).regex(/^[A-Za-z0-9_.-]+$/, "must be an SSH user token");
+var absolutePath = z.string().min(1).regex(/^\//, "must be an absolute path");
 var FleetAccessProfileSchema = z.object({
   status: z.enum(["local", "configured", "planned", "absent", "unknown"]),
   ssh_aliases: z.array(sshAlias).optional(),
@@ -200,6 +201,26 @@ var FleetHostIdentitySchema = z.object({
     addresses: z.array(ipAddress).optional()
   }).strict().optional()
 }).strict();
+var FleetSkillwikiSatelliteSchema = z.object({
+  enabled: z.boolean(),
+  user: sshUser,
+  vault_path: absolutePath,
+  repo_path: absolutePath,
+  ssh_alias: sshAlias,
+  scheduler: z.enum(["systemd"]),
+  timezone: z.string().min(1).optional(),
+  jobs: z.array(z.enum([
+    "self-update-check",
+    "vault-sync-preflight",
+    "agent-memory-trends-daily",
+    "session-brief-refresh",
+    "health-summary"
+  ])).min(1),
+  cadence: z.object({
+    self_update_check: z.literal("every-4-hours").optional(),
+    daily_window: z.string().min(1).optional()
+  }).strict().optional()
+}).strict();
 var FleetHostSchema = z.object({
   class: z.enum(["dev-macos", "dev-linux", "prod-linux", "unknown"]),
   role: z.enum(["leaf", "snapshotter"]),
@@ -208,6 +229,9 @@ var FleetHostSchema = z.object({
   identity: FleetHostIdentitySchema,
   access: z.object({
     from: z.record(hostId, FleetAccessProfileSchema).optional()
+  }).strict().optional(),
+  maintenance: z.object({
+    skillwiki_satellite: FleetSkillwikiSatelliteSchema.optional()
   }).strict().optional()
 }).strict();
 var FleetManifestSchema = z.object({
@@ -9625,7 +9649,8 @@ function formatKnownContext(input) {
   const protectedValue = host.protected === true ? "true" : "false";
   const writesTo = host.writes_to.join(", ");
   const selfAliases = collectSelfAliases(input.manifest, input.hostId);
-  const outbound = collectOutboundHosts(input.manifest, input.hostId);
+  const outbound = collectOutboundAccess(input.manifest, input.hostId);
+  const maintenanceLines = formatMaintenanceLines(host);
   const guidance = input.hostId === "macos-dev" ? "use declared SSH aliases for remote work when needed; do not assume undeclared hosts have reciprocal SSH access." : `this session is already on \`${input.hostId}\`; do not SSH to self aliases unless the user explicitly asks. Do not assume outbound SSH to other fleet hosts is configured.`;
   return [
     "## Runtime Host Context",
@@ -9636,8 +9661,9 @@ function formatKnownContext(input) {
     `- Workspace: ${formatMaybe(input.cwd)}`,
     `- Vault: ${formatMaybe(input.vault)}`,
     `- Fleet role: \`${host.role}\`; protected: \`${protectedValue}\`; writes_to: \`${writesTo}\``,
+    ...maintenanceLines,
     `- Self SSH aliases known in fleet: ${formatList(selfAliases)}`,
-    `- Declared outbound SSH from this source: ${outbound.length > 0 ? formatList(outbound) : "none"}`,
+    `- Declared outbound SSH from this source: ${formatOutboundAccess(outbound)}`,
     `- Guidance: ${guidance}`
   ].join("\n");
 }
@@ -9665,16 +9691,36 @@ function collectSelfAliases(manifest, hostId2) {
   }
   return [...new Set(aliases)];
 }
-function collectOutboundHosts(manifest, sourceHostId) {
+function collectOutboundAccess(manifest, sourceHostId) {
   const hosts = [];
   for (const [targetId, target] of Object.entries(manifest.hosts)) {
     if (targetId === sourceHostId) continue;
     const profile = target.access?.from?.[sourceHostId];
     if (profile && (profile.status === "configured" || profile.status === "local")) {
-      hosts.push(targetId);
+      hosts.push({
+        hostId: targetId,
+        sshAliases: [...new Set(profile.ssh_aliases ?? [])],
+        users: [...new Set(profile.users ?? [])]
+      });
     }
   }
-  return hosts.sort();
+  return hosts.sort((left, right) => left.hostId.localeCompare(right.hostId));
+}
+function formatMaintenanceLines(host) {
+  const satellite = host.maintenance?.skillwiki_satellite;
+  if (!satellite?.enabled) return [];
+  return [
+    `- Maintenance role: \`skillwiki satellite\`; user: \`${satellite.user}\`; ssh: \`${satellite.ssh_alias}\``,
+    `- Maintenance paths: maintenance vault: \`${satellite.vault_path}\`; repo: \`${satellite.repo_path}\`; scheduler: \`${satellite.scheduler}\`; jobs: ${formatList(satellite.jobs)}`
+  ];
+}
+function formatOutboundAccess(values) {
+  if (values.length === 0) return "none";
+  return values.map((value) => {
+    const aliasPart = value.sshAliases.length > 0 ? ` via ${formatList(value.sshAliases)}` : " (no SSH aliases)";
+    const usersPart = value.users.length > 0 ? ` (users: ${formatList(value.users)})` : "";
+    return `\`${value.hostId}\`${aliasPart}${usersPart}`;
+  }).join("; ");
 }
 function formatList(values) {
   return values.length > 0 ? values.map((v) => `\`${v}\``).join(", ") : "none";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.8.10",
+  "version": "0.9.1-beta.1",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js"

package/skills/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.8.10",
+  "version": "0.9.1-beta.1",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 18 prompt-only skills (wiki-*, proj-*, using-skillwiki) backed by the deterministic `skillwiki` CLI.",
   "author": {

package/skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.8.10",
+  "version": "0.9.1-beta.1",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 18 prompt-only skills backed by the deterministic skillwiki CLI.",
   "author": {
     "name": "karlorz",

package/skills/agents/wiki-adapter-prd.md

@@ -36,7 +36,7 @@ You are a PRD format adapter specializing in mapping foreign design document for
 | Requirements list | `concepts/` or `entities/` |
 | Architecture decisions | `concepts/` with `tags: [architecture]` |
 | Motivation / context | `entities/` |
-| Trade-offs / comparisons | `comparisons/` |
+| Trade-offs / comparisons | `comparisons/` with a `Decision Closeout` block |
 | Action items / next steps | Skip (project management, not knowledge) |
 
 **Execution Process:**
@@ -51,6 +51,15 @@ You are a PRD format adapter specializing in mapping foreign design document for
    - `## TL;DR` as first section
    - Preserve requirement IDs as tags or inline references
    - Convert internal links to `[[wikilinks]]` where pages exist
+   - For generated comparison or evaluation pages, end with:
+     ```markdown
+     ## Decision Closeout
+
+     Disposition: no-op | concept | ADR | work-item | evidence-needed
+     Reason: ...
+     Follow-up: ...
+     ```
+     Use exactly one disposition. Keep skipped action items out of typed knowledge unless the closeout disposition is `work-item`.
 7. **Validate.** `skillwiki validate <page>` for each page. If any non-zero, STOP.
 8. **Apply writes:** raw → pages → `index.md` → `log.md`.
 

package/skills/agents/wiki-crystallize.md

@@ -32,6 +32,15 @@ You are a knowledge crystallizer specializing in distilling raw session material
    - Citations using `^[raw/...]` markers for every factual claim
    - For pages tagged `architecture` or explaining workflows: a Mermaid diagram (`graph TB` or `sequenceDiagram`)
    - Tags must come from `{vault}/SCHEMA.md` taxonomy only. If no relevant tag exists, use `[dev-loop]`.
+   - For `comparison`, evaluation-style `query`, or research-summary pages, end with:
+     ```markdown
+     ## Decision Closeout
+
+     Disposition: no-op | concept | ADR | work-item | evidence-needed
+     Reason: ...
+     Follow-up: ...
+     ```
+     Use exactly one disposition. Keep this as a prompt/template convention, not validation or lint enforcement.
 6. **Validate.** Run `skillwiki validate <page>`. If non-zero, fix issues and re-validate. Do NOT proceed until validation passes.
 7. **Apply writes in order:** Page file → add entry to `{vault}/index.md` → append entry to `{vault}/log.md`.
 

package/skills/agents/wiki-ingest.md

@@ -34,6 +34,15 @@ You are a vault ingestion specialist converting source material (URLs, files, te
    - `^[raw/...]` citations for every factual claim
    - Mermaid diagram if tagged `architecture` or explaining workflows
    - `confidence: low` if only one source cited
+   - For generated `comparisons/` pages or evaluation-style `queries/` pages, end with:
+     ```markdown
+     ## Decision Closeout
+
+     Disposition: no-op | concept | ADR | work-item | evidence-needed
+     Reason: ...
+     Follow-up: ...
+     ```
+     Use exactly one disposition. This is a prompt convention, not a validator rule.
 6. **Validate.** For each page: `skillwiki validate <page>`. If any non-zero, fix issues and re-validate. Do NOT proceed until all pages pass.
 7. **Apply writes in order:** raw file(s) → page(s) → update `index.md` → append `log.md`.
 

package/skills/agents/wiki-query.md

@@ -34,7 +34,15 @@ You are a vault search and synthesis specialist using E2 4-signal ranking to fin
    - Type affinity: 1.0×
 6. **Read top candidates.** Read frontmatter + body of highest-scored pages.
 7. **Synthesize answer.** Compose with explicit citations to candidate pages using `^[page-path]` markers.
-8. **Optional file.** If the task asks to persist: write to `queries/<slug>.md` or `comparisons/<slug>.md` with full frontmatter, validate, then update `index.md` → `log.md`.
+8. **Optional file.** If the task asks to persist: write to `queries/<slug>.md` or `comparisons/<slug>.md` with full frontmatter, validate, then update `index.md` → `log.md`. If the filed page is a research/evaluation answer, recommendation, or comparison, end it with:
+   ```markdown
+   ## Decision Closeout
+
+   Disposition: no-op | concept | ADR | work-item | evidence-needed
+   Reason: ...
+   Follow-up: ...
+   ```
+   Use exactly one disposition. This is a prompt convention only; do not add CLI enforcement here.
 
 ### Verification Rule
 When a wiki page (especially a work item tasks.md) claims fixes were applied or features completed, **verify on disk before accepting**. Check file existence, grep config, inspect crontab. The filesystem is the source of truth — wiki pages can drift.

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.8.10",
+  "version": "0.9.1-beta.1",
   "private": true,
   "files": [
     "wiki-*",

package/skills/skills/wiki-adapter-prd/SKILL.md

@@ -48,7 +48,7 @@ Map source sections to typed-knowledge pages:
 | Requirements list | `concepts/` or `entities/` | Each major requirement becomes its own page or a section in a compound page |
 | Architecture decisions | `concepts/` | Map to concept pages with `tags: [architecture]` |
 | Motivation / context | `entities/` | Capture as entity pages describing the system or component |
-| Trade-offs / comparisons | `comparisons/` | Create comparison pages when the source weighs alternatives |
+| Trade-offs / comparisons | `comparisons/` | Create comparison pages when the source weighs alternatives; include a `Decision Closeout` block |
 | Action items / next steps | Skip | Not knowledge — track in project work items instead |
 
 ### Cross-reference handling
@@ -65,6 +65,15 @@ Map source sections to typed-knowledge pages:
 3. Write raw capture: frontmatter + full body → `raw/articles/<slug>.md`.
 4. Run `skillwiki hash <raw-file>`, embed sha256.
 5. Generate typed-knowledge pages following the mapping strategy.
+   For generated comparison or evaluation pages, end the body with:
+   ```markdown
+   ## Decision Closeout
+
+   Disposition: no-op | concept | ADR | work-item | evidence-needed
+   Reason: ...
+   Follow-up: ...
+   ```
+   Use exactly one disposition. Preserve action items as skipped project-management content unless the closeout explicitly says `work-item`.
 6. For each page: run `skillwiki validate <page>`. If any fails, STOP.
 7. Write pages, then update `index.md` and `log.md`.
 

package/skills/skills/wiki-crystallize/SKILL.md

@@ -17,6 +17,15 @@ Standard four reads. If cwd is inside `projects/{slug}/`, also read project READ
 3. Compose the page with citations pre-attached. Reuse existing `raw/` sources where possible. Every page MUST include:
 - `> **TL;DR:**` blockquote as the first content after the title heading — a one-sentence summary of the page's key takeaway (under 200 chars). See SCHEMA.md `## TL;DR Convention`.
 - For pages tagged `architecture` or explaining workflows/systems: include a Mermaid diagram (`graph TB` or `sequenceDiagram`) in the body. Follow Obsidian-compatible Mermaid rules (see SCHEMA.md `## Mermaid Diagrams`).
+For `comparison`, evaluation-style `query`, or research-summary pages, end the body with:
+```markdown
+## Decision Closeout
+
+Disposition: no-op | concept | ADR | work-item | evidence-needed
+Reason: ...
+Follow-up: ...
+```
+Use exactly one disposition. Keep this as a prompt/template convention; do not add validation or lint enforcement.
 4. `skillwiki validate <page>`. If non-zero, STOP.
 5. Apply writes: page → `index.md` → `log.md`.
 ## Stop conditions

package/skills/skills/wiki-ingest/SKILL.md

@@ -23,6 +23,15 @@ Run `skillwiki lang` at the start. Generate page-body prose, narrative sections,
 5. **Generate page(s).** Compose typed-knowledge page(s) with citations pre-attached (`^[raw/...]` markers). Every page MUST include:
 - `> **TL;DR:**` blockquote as the first content after the title heading — a one-sentence summary of the page's key takeaway (under 200 chars). See SCHEMA.md `## TL;DR Convention`.
 - For pages tagged `architecture` or explaining workflows/systems: include a Mermaid diagram (`graph TB` or `sequenceDiagram`) in the body. Follow Obsidian-compatible Mermaid rules (see SCHEMA.md `## Mermaid Diagrams`).
+For generated `comparisons/` pages or evaluation-style `queries/` pages, end the body with:
+```markdown
+## Decision Closeout
+
+Disposition: no-op | concept | ADR | work-item | evidence-needed
+Reason: ...
+Follow-up: ...
+```
+Use exactly one disposition. Keep this as a prompt convention, not a validator rule.
 6. **Validate.** For each generated page: run `skillwiki validate <page>`. If exit ≠ 0, STOP — do not write index/log.
 7. **Apply writes in order.** raw → page(s) → `index.md` → `log.md`.
 8. **Confidence flag.** If only one source is cited, set `confidence: low`.

package/skills/skills/wiki-query/SKILL.md

@@ -22,7 +22,15 @@ Standard four reads (SCHEMA, index, log, project context if applicable).
 - Type affinity: 1.0×
 5. **Read top candidates** in full (frontmatter + body).
 6. **Synthesize answer** with explicit citations to the candidate pages.
-7. **Optional file.** If user accepts: write to `queries/<slug>.md` or `comparisons/<slug>.md` with full frontmatter, validate, then update `index.md` then `log.md`.
+7. **Optional file.** If user accepts: write to `queries/<slug>.md` or `comparisons/<slug>.md` with full frontmatter, validate, then update `index.md` then `log.md`. If the filed page is a research/evaluation answer, recommendation, or comparison, end it with:
+```markdown
+## Decision Closeout
+
+Disposition: no-op | concept | ADR | work-item | evidence-needed
+Reason: ...
+Follow-up: ...
+```
+Use exactly one disposition. This is a prompt convention only; do not add CLI enforcement here.
 ## Stop conditions
 - Zero matching pages.
 - User declines to file.

package/skills/wiki-adapter-prd/SKILL.md

@@ -48,7 +48,7 @@ Map source sections to typed-knowledge pages:
 | Requirements list | `concepts/` or `entities/` | Each major requirement becomes its own page or a section in a compound page |
 | Architecture decisions | `concepts/` | Map to concept pages with `tags: [architecture]` |
 | Motivation / context | `entities/` | Capture as entity pages describing the system or component |
-| Trade-offs / comparisons | `comparisons/` | Create comparison pages when the source weighs alternatives |
+| Trade-offs / comparisons | `comparisons/` | Create comparison pages when the source weighs alternatives; include a `Decision Closeout` block |
 | Action items / next steps | Skip | Not knowledge — track in project work items instead |
 
 ### Cross-reference handling
@@ -65,6 +65,15 @@ Map source sections to typed-knowledge pages:
 3. Write raw capture: frontmatter + full body → `raw/articles/<slug>.md`.
 4. Run `skillwiki hash <raw-file>`, embed sha256.
 5. Generate typed-knowledge pages following the mapping strategy.
+   For generated comparison or evaluation pages, end the body with:
+   ```markdown
+   ## Decision Closeout
+
+   Disposition: no-op | concept | ADR | work-item | evidence-needed
+   Reason: ...
+   Follow-up: ...
+   ```
+   Use exactly one disposition. Preserve action items as skipped project-management content unless the closeout explicitly says `work-item`.
 6. For each page: run `skillwiki validate <page>`. If any fails, STOP.
 7. Write pages, then update `index.md` and `log.md`.
 

package/skills/wiki-crystallize/SKILL.md

@@ -17,6 +17,15 @@ Standard four reads. If cwd is inside `projects/{slug}/`, also read project READ
 3. Compose the page with citations pre-attached. Reuse existing `raw/` sources where possible. Every page MUST include:
 - `> **TL;DR:**` blockquote as the first content after the title heading — a one-sentence summary of the page's key takeaway (under 200 chars). See SCHEMA.md `## TL;DR Convention`.
 - For pages tagged `architecture` or explaining workflows/systems: include a Mermaid diagram (`graph TB` or `sequenceDiagram`) in the body. Follow Obsidian-compatible Mermaid rules (see SCHEMA.md `## Mermaid Diagrams`).
+For `comparison`, evaluation-style `query`, or research-summary pages, end the body with:
+```markdown
+## Decision Closeout
+
+Disposition: no-op | concept | ADR | work-item | evidence-needed
+Reason: ...
+Follow-up: ...
+```
+Use exactly one disposition. Keep this as a prompt/template convention; do not add validation or lint enforcement.
 4. `skillwiki validate <page>`. If non-zero, STOP.
 5. Apply writes: page → `index.md` → `log.md`.
 ## Stop conditions

package/skills/wiki-ingest/SKILL.md

@@ -23,6 +23,15 @@ Run `skillwiki lang` at the start. Generate page-body prose, narrative sections,
 5. **Generate page(s).** Compose typed-knowledge page(s) with citations pre-attached (`^[raw/...]` markers). Every page MUST include:
 - `> **TL;DR:**` blockquote as the first content after the title heading — a one-sentence summary of the page's key takeaway (under 200 chars). See SCHEMA.md `## TL;DR Convention`.
 - For pages tagged `architecture` or explaining workflows/systems: include a Mermaid diagram (`graph TB` or `sequenceDiagram`) in the body. Follow Obsidian-compatible Mermaid rules (see SCHEMA.md `## Mermaid Diagrams`).
+For generated `comparisons/` pages or evaluation-style `queries/` pages, end the body with:
+```markdown
+## Decision Closeout
+
+Disposition: no-op | concept | ADR | work-item | evidence-needed
+Reason: ...
+Follow-up: ...
+```
+Use exactly one disposition. Keep this as a prompt convention, not a validator rule.
 6. **Validate.** For each generated page: run `skillwiki validate <page>`. If exit ≠ 0, STOP — do not write index/log.
 7. **Apply writes in order.** raw → page(s) → `index.md` → `log.md`.
 8. **Confidence flag.** If only one source is cited, set `confidence: low`.

package/skills/wiki-query/SKILL.md

@@ -22,7 +22,15 @@ Standard four reads (SCHEMA, index, log, project context if applicable).
 - Type affinity: 1.0×
 5. **Read top candidates** in full (frontmatter + body).
 6. **Synthesize answer** with explicit citations to the candidate pages.
-7. **Optional file.** If user accepts: write to `queries/<slug>.md` or `comparisons/<slug>.md` with full frontmatter, validate, then update `index.md` then `log.md`.
+7. **Optional file.** If user accepts: write to `queries/<slug>.md` or `comparisons/<slug>.md` with full frontmatter, validate, then update `index.md` then `log.md`. If the filed page is a research/evaluation answer, recommendation, or comparison, end it with:
+```markdown
+## Decision Closeout
+
+Disposition: no-op | concept | ADR | work-item | evidence-needed
+Reason: ...
+Follow-up: ...
+```
+Use exactly one disposition. This is a prompt convention only; do not add CLI enforcement here.
 ## Stop conditions
 - Zero matching pages.
 - User declines to file.