skillwiki 0.10.63 → 0.10.65

package/dist/{chunk-EFPIN7DQ.js → chunk-BPJ5KWIT.js}

@@ -8,7 +8,7 @@ import {
   ok,
   scanSensitiveContent,
   scanVault
-} from "./chunk-SI6DDQIV.js";
+} from "./chunk-HJ4ALQG6.js";
 
 // src/utils/atomic-write.ts
 import { randomBytes } from "crypto";

package/dist/{chunk-X45H2KXI.js → chunk-CKDF4DWU.js}

@@ -2,7 +2,7 @@
 import {
   atomicWriteText,
   buildRootIndexUniverse
-} from "./chunk-EFPIN7DQ.js";
+} from "./chunk-BPJ5KWIT.js";
 import {
   authorizeRawOperation,
   buildSourceReferenceIndex,
@@ -22,7 +22,7 @@ import {
   resolveExistingRegularFileInsideVault,
   stripFencedBlocks,
   writeLogEvent
-} from "./chunk-Q66UASXZ.js";
+} from "./chunk-OMO45AHI.js";
 import {
   ExitCode,
   FleetManifestSchema,
@@ -41,7 +41,7 @@ import {
   scanVault,
   splitFrontmatter,
   vaultIoConcurrency
-} from "./chunk-SI6DDQIV.js";
+} from "./chunk-HJ4ALQG6.js";
 
 // src/utils/managed-write-preflight.ts
 import { existsSync as existsSync11 } from "fs";

package/dist/{chunk-SI6DDQIV.js → chunk-HJ4ALQG6.js}

@@ -176,6 +176,16 @@ var RawSourceSchema = z.object({
     ctx.addIssue({ code: z.ZodIssueCode.custom, message: "project and kind are required when work_item is set" });
   }
 });
+var PostReleaseVerificationSchema = z.object({
+  posture: z.literal("opt-in"),
+  triggers: z.array(z.enum([
+    "matching-regression-report",
+    "explicit-user-request",
+    "relevant-code-or-release-change"
+  ])).min(1),
+  last_proven: isoDate.optional(),
+  evidence: z.array(z.string().min(1)).optional()
+}).strict();
 var WorkItemSchema = z.object({
   title: z.string().min(1),
   aliases: z.array(z.string()).optional(),
@@ -190,11 +200,19 @@ var WorkItemSchema = z.object({
   owner: wikilink.optional(),
   parent: wikilink.optional(),
   related: z.array(wikilink).optional(),
-  sources: z.array(z.string()).optional()
+  sources: z.array(z.string()).optional(),
+  post_release_verification: PostReleaseVerificationSchema.optional()
 }).superRefine((v, ctx) => {
   if (v.status === "completed" && !v.completed) {
     ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["completed"], message: "required when status is completed" });
   }
+  if (v.post_release_verification && v.status !== "completed") {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ["post_release_verification"],
+      message: "post-release verification requires status completed"
+    });
+  }
 });
 var CompoundSchema = z.object({
   title: z.string().min(1),

package/dist/{chunk-MDLROHRP.js → chunk-KFEOMMWK.js}

@@ -3,11 +3,11 @@ import {
   ROOT_INDEX_SECTION_ORDER,
   atomicWriteText,
   buildRootIndexUniverse
-} from "./chunk-EFPIN7DQ.js";
+} from "./chunk-BPJ5KWIT.js";
 import {
   err,
   ok
-} from "./chunk-SI6DDQIV.js";
+} from "./chunk-HJ4ALQG6.js";
 
 // src/utils/index-projection.ts
 import { readFile } from "fs/promises";

package/dist/{chunk-S663QZQR.js → chunk-NPTIYO2S.js}

@@ -8,7 +8,7 @@ import {
   readLogEvents,
   resolveExistingRegularFileInsideVault,
   writeLogEvent
-} from "./chunk-Q66UASXZ.js";
+} from "./chunk-OMO45AHI.js";
 import {
   ExitCode,
   RawSourceSchema,
@@ -19,7 +19,7 @@ import {
   scanSensitiveContent,
   scanVault,
   splitFrontmatter
-} from "./chunk-SI6DDQIV.js";
+} from "./chunk-HJ4ALQG6.js";
 
 // src/commands/sources.ts
 import { readFile as readFile4 } from "fs/promises";

package/dist/{chunk-Q66UASXZ.js → chunk-OMO45AHI.js}

@@ -6,7 +6,7 @@ import {
   readPage,
   scanSensitiveContent,
   splitFrontmatter
-} from "./chunk-SI6DDQIV.js";
+} from "./chunk-HJ4ALQG6.js";
 
 // src/utils/vault-path-safety.ts
 import { lstatSync, realpathSync } from "fs";

package/dist/{chunk-4JZD2IAC.js → chunk-SNHTWLGF.js}

@@ -6,7 +6,7 @@ import {
 import {
   renderRootIndex,
   writeRootIndexProjection
-} from "./chunk-MDLROHRP.js";
+} from "./chunk-KFEOMMWK.js";
 import {
   CONFIG_KEYS,
   VAULT_HYGIENE_GENERATED_COMMIT_PATHS,
@@ -40,11 +40,11 @@ import {
   snapshotterAliasForLocalHost,
   toUndirectedWeighted,
   writeDotenv
-} from "./chunk-X45H2KXI.js";
+} from "./chunk-CKDF4DWU.js";
 import {
   atomicWriteText,
   prepareTypedPage
-} from "./chunk-EFPIN7DQ.js";
+} from "./chunk-BPJ5KWIT.js";
 import {
   applySourceCompileClaim,
   applySourceCompilePublished,
@@ -57,11 +57,11 @@ import {
   planSourceCompileRelease,
   planSourceReview,
   runSourcesPending
-} from "./chunk-S663QZQR.js";
+} from "./chunk-NPTIYO2S.js";
 import {
   eventPathFor,
   writeLogEvent
-} from "./chunk-Q66UASXZ.js";
+} from "./chunk-OMO45AHI.js";
 import {
   CompoundSchema,
   ExitCode,
@@ -82,7 +82,7 @@ import {
   scanVault,
   splitFrontmatter,
   systemdPropertyFor
-} from "./chunk-SI6DDQIV.js";
+} from "./chunk-HJ4ALQG6.js";
 
 // src/commands/log-append.ts
 import { readFile, stat } from "fs/promises";
@@ -6096,7 +6096,7 @@ async function runQuery(input) {
   }
   let pendingSources;
   if (input.includePending) {
-    const { runSourcesPending: runSourcesPending2 } = await import("./sources-LP76JPY5.js");
+    const { runSourcesPending: runSourcesPending2 } = await import("./sources-C4LUWNET.js");
     const pending = await runSourcesPending2({
       vault: input.vault,
       match: input.text,

package/dist/cli.js

@@ -50,7 +50,7 @@ import {
   snapshotterHealthChecks,
   upsertIndexEntry,
   vectorIndexStatus
-} from "./chunk-4JZD2IAC.js";
+} from "./chunk-SNHTWLGF.js";
 import {
   normalizeDistTag,
   readCache,
@@ -63,7 +63,7 @@ import {
   UNMANAGED_START,
   renderRootIndex,
   writeRootIndexProjection
-} from "./chunk-MDLROHRP.js";
+} from "./chunk-KFEOMMWK.js";
 import {
   FLEET_REL_PATH,
   REDACTED_MALFORMED_REFERENCE,
@@ -151,12 +151,12 @@ import {
   supersedeStaleReviewRequiredJournals,
   taxonomyCommentForPage,
   writeDotenv
-} from "./chunk-X45H2KXI.js";
+} from "./chunk-CKDF4DWU.js";
 import {
   assertTargetInsideVault,
   atomicWriteText,
   prepareTypedPage
-} from "./chunk-EFPIN7DQ.js";
+} from "./chunk-BPJ5KWIT.js";
 import {
   applySourceDisposition,
   decodeSourceActionApproval,
@@ -164,7 +164,7 @@ import {
   inventorySources,
   planSourceDisposition,
   runSourcesPending
-} from "./chunk-S663QZQR.js";
+} from "./chunk-NPTIYO2S.js";
 import {
   authorizeRawOperation,
   buildSourceReferenceIndex,
@@ -181,7 +181,7 @@ import {
   resolveExistingRegularFileInsideVault,
   validateLogEvent,
   writeLogEvent
-} from "./chunk-Q66UASXZ.js";
+} from "./chunk-OMO45AHI.js";
 import {
   ExitCode,
   MetaSchema,
@@ -202,7 +202,7 @@ import {
   scanVault,
   splitFrontmatter,
   vaultIoConcurrency
-} from "./chunk-SI6DDQIV.js";
+} from "./chunk-HJ4ALQG6.js";
 
 // src/cli.ts
 import { join as join42 } from "path";
@@ -3767,7 +3767,7 @@ ${fmRewritten}
   }
   let indexUpdated = false;
   if (!isRaw) {
-    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-LUXJDMUG.js");
+    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-J5IV7NH3.js");
     const before = await readFile7(join19(input.vault, "index.md"), "utf8").catch(() => "");
     const fullTarget = relPath.replace(/\.md$/, "");
     const bare = fullTarget.split("/").pop() ?? fullTarget;
@@ -3890,7 +3890,7 @@ async function runRemove(input) {
   if (relPath.endsWith(".md") && !relPath.startsWith("raw/")) {
     const { readFile: readFile22 } = await import("fs/promises");
     const { join: pathJoin } = await import("path");
-    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-LUXJDMUG.js");
+    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-J5IV7NH3.js");
     const before = await readFile22(pathJoin(input.vault, "index.md"), "utf8").catch(() => "");
     const fullTarget = relPath.replace(/\.md$/, "");
     const bare = fullTarget.split("/").pop() ?? fullTarget;
@@ -10410,7 +10410,7 @@ async function emitManagedVaultWrite(vault, command, mutate, opts) {
   if (dirty) {
     return emit(dirty, void 0, { postCommit: false });
   }
-  const { runManagedWriteTransaction: runManagedWriteTransaction2 } = await import("./managed-write-preflight-GQN7ZW7O.js");
+  const { runManagedWriteTransaction: runManagedWriteTransaction2 } = await import("./managed-write-preflight-2MMVUXD3.js");
   const run = await runManagedWriteTransaction2({
     vault,
     command,

package/dist/{index-projection-LUXJDMUG.js → index-projection-J5IV7NH3.js}

@@ -4,9 +4,9 @@ import {
   UNMANAGED_START,
   renderRootIndex,
   writeRootIndexProjection
-} from "./chunk-MDLROHRP.js";
-import "./chunk-EFPIN7DQ.js";
-import "./chunk-SI6DDQIV.js";
+} from "./chunk-KFEOMMWK.js";
+import "./chunk-BPJ5KWIT.js";
+import "./chunk-HJ4ALQG6.js";
 export {
   UNMANAGED_END,
   UNMANAGED_START,

package/dist/{managed-write-preflight-GQN7ZW7O.js → managed-write-preflight-2MMVUXD3.js}

@@ -6,10 +6,10 @@ import {
   runManagedWritePeerGate,
   runManagedWritePreflight,
   runManagedWriteTransaction
-} from "./chunk-X45H2KXI.js";
-import "./chunk-EFPIN7DQ.js";
-import "./chunk-Q66UASXZ.js";
-import "./chunk-SI6DDQIV.js";
+} from "./chunk-CKDF4DWU.js";
+import "./chunk-BPJ5KWIT.js";
+import "./chunk-OMO45AHI.js";
+import "./chunk-HJ4ALQG6.js";
 export {
   DEFAULT_MANAGED_WRITE_WAIT_MS,
   MANAGED_WRITE_POLL_INTERVAL_MS,

package/dist/skillwiki-mcp.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-4JZD2IAC.js";
+} from "./chunk-SNHTWLGF.js";
 import "./chunk-7I2TPIV5.js";
-import "./chunk-MDLROHRP.js";
-import "./chunk-X45H2KXI.js";
-import "./chunk-EFPIN7DQ.js";
-import "./chunk-S663QZQR.js";
-import "./chunk-Q66UASXZ.js";
-import "./chunk-SI6DDQIV.js";
+import "./chunk-KFEOMMWK.js";
+import "./chunk-CKDF4DWU.js";
+import "./chunk-BPJ5KWIT.js";
+import "./chunk-NPTIYO2S.js";
+import "./chunk-OMO45AHI.js";
+import "./chunk-HJ4ALQG6.js";
 
 // src/mcp-entry.ts
 runSkillwikiMcpStdio().catch((error) => {

package/dist/sources-C4LUWNET.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import {
+  runSourcesPending
+} from "./chunk-NPTIYO2S.js";
+import "./chunk-OMO45AHI.js";
+import "./chunk-HJ4ALQG6.js";
+export {
+  runSourcesPending
+};

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.63",
+  "version": "0.10.65",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 20 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.10.63",
+  "version": "0.10.65",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 20 prompt-only skills backed by the deterministic skillwiki CLI.",
   "author": {
     "name": "karlorz",

package/skills/README.md

@@ -38,6 +38,12 @@ Each top-level skill subdirectory holds one canonical `SKILL.md`. The nested
 `skills/<skill>/SKILL.md` tree mirrors those files for Codex plugin discovery;
 keep it byte-for-byte in sync with the canonical top-level files.
 
+`description` is routing metadata for every skill, not a README. Author to
+180 characters (CI fails above 220). Unique-canonical totals are capped with
+agent-skills so the combined Codex catalog stays at 8,000 characters. See
+vault concept `concepts/codex-skill-catalog-budget.md`. Run
+`python3 scripts/lint-skill-descriptions.py --layout llm-wiki --max-total-chars 3200`.
+
 Codex installs through `packages/codex-skills`, a materialized plugin root that
 copies this package's `.codex-plugin/` manifest, `skills/` mirror, and
 Codex-specific hook files. That root exposes `hooks/hooks-codex.json` and

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.10.63",
+  "version": "0.10.65",
   "private": true,
   "files": [
     "wiki-*",

package/skills/proj-work/SKILL.md

@@ -49,6 +49,22 @@ When the user asks to "get work of X" or "run work item Y" for review, you are i
 5. Manage status transitions: `planned` → `in-progress` → `completed` (set `completed:` date) or `abandoned`.
 6. Append vault `log.md` entry on creation and on each status transition.
 
+### Completion and post-release verification
+
+- Work-item status represents delivery lifecycle. Mark delivery complete when
+  the approved code, required acceptance checks, release/deployment scope, and
+  completion evidence are finished.
+- Required acceptance verification remains part of the completion checklist and
+  must pass before `status: completed`.
+- Optional verification after delivery uses typed frontmatter:
+  `post_release_verification.posture: opt-in`, plus one or more approved
+  `triggers` (`matching-regression-report`, `explicit-user-request`, or
+  `relevant-code-or-release-change`).
+- Record opt-in post-release checks as prose evidence, not as unchecked completion tasks.
+  Completed opt-in work stays out of ordinary active rankings until a trigger
+  occurs; a trigger creates new evidence or a follow-up decision rather than
+  silently keeping delivered work `in-progress`.
+
 ## Redirect Output
 
 After step 3 (output path override), emit redirect paths for the active PRD skill:

package/skills/skills/proj-work/SKILL.md

@@ -49,6 +49,22 @@ When the user asks to "get work of X" or "run work item Y" for review, you are i
 5. Manage status transitions: `planned` → `in-progress` → `completed` (set `completed:` date) or `abandoned`.
 6. Append vault `log.md` entry on creation and on each status transition.
 
+### Completion and post-release verification
+
+- Work-item status represents delivery lifecycle. Mark delivery complete when
+  the approved code, required acceptance checks, release/deployment scope, and
+  completion evidence are finished.
+- Required acceptance verification remains part of the completion checklist and
+  must pass before `status: completed`.
+- Optional verification after delivery uses typed frontmatter:
+  `post_release_verification.posture: opt-in`, plus one or more approved
+  `triggers` (`matching-regression-report`, `explicit-user-request`, or
+  `relevant-code-or-release-change`).
+- Record opt-in post-release checks as prose evidence, not as unchecked completion tasks.
+  Completed opt-in work stays out of ordinary active rankings until a trigger
+  occurs; a trigger creates new evidence or a follow-up decision rather than
+  silently keeping delivered work `in-progress`.
+
 ## Redirect Output
 
 After step 3 (output path override), emit redirect paths for the active PRD skill:

package/skills/skills/using-skillwiki/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: using-skillwiki
-description: Invoke when vault, wiki, knowledge-base, or SkillWiki setup work arises — maps skillwiki skills, dev-loop alignment, adaptive workflow profiles, and vault routing. Do not invoke for unrelated coding or creative tasks.
+description: Invoke for vault, wiki, or SkillWiki setup. Maps skills, workflow profiles, and vault routing. Skip unrelated coding.
 ---
 *Note: If executing as a background subagent, skip this skill section.*
 

package/skills/skills/wiki-freshness-repair/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wiki-freshness-repair
-description: Repair stale vault sources end to end. Consumes skillwiki drift --affected-pages, re-ingests changed sources through wiki-reingest, then republishes the affected typed pages through the page publish approval flow. Attended only; never auto-repairs.
+description: Repair stale vault sources via drift, reingest, and attended republish. Use when skillwiki drift lists affected pages.
 ---
 
 # wiki-freshness-repair

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

@@ -1,6 +1,6 @@
 ---
 name: wiki-sync
-description: Safely sync the vault git repository — multi-session safe via advisory lockfile. Handles rebase conflict storms from archive-commit × snapshot-stream patterns. Runs skillwiki sync status, then guides push or pull with lint guards and conflict resolution.
+description: Safely sync vault git with a lockfile and lint guards. Use to push or pull wiki changes across sessions.
 ---
 # wiki-sync
 ## When This Skill Activates

package/skills/using-skillwiki/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: using-skillwiki
-description: Invoke when vault, wiki, knowledge-base, or SkillWiki setup work arises — maps skillwiki skills, dev-loop alignment, adaptive workflow profiles, and vault routing. Do not invoke for unrelated coding or creative tasks.
+description: Invoke for vault, wiki, or SkillWiki setup. Maps skills, workflow profiles, and vault routing. Skip unrelated coding.
 ---
 *Note: If executing as a background subagent, skip this skill section.*
 

package/skills/wiki-freshness-repair/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wiki-freshness-repair
-description: Repair stale vault sources end to end. Consumes skillwiki drift --affected-pages, re-ingests changed sources through wiki-reingest, then republishes the affected typed pages through the page publish approval flow. Attended only; never auto-repairs.
+description: Repair stale vault sources via drift, reingest, and attended republish. Use when skillwiki drift lists affected pages.
 ---
 
 # wiki-freshness-repair

package/skills/wiki-sync/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wiki-sync
-description: Safely sync the vault git repository — multi-session safe via advisory lockfile. Handles rebase conflict storms from archive-commit × snapshot-stream patterns. Runs skillwiki sync status, then guides push or pull with lint guards and conflict resolution.
+description: Safely sync vault git with a lockfile and lint guards. Use to push or pull wiki changes across sessions.
 ---
 # wiki-sync
 ## When This Skill Activates

package/dist/sources-LP76JPY5.js

@@ -1,9 +0,0 @@
-#!/usr/bin/env node
-import {
-  runSourcesPending
-} from "./chunk-S663QZQR.js";
-import "./chunk-Q66UASXZ.js";
-import "./chunk-SI6DDQIV.js";
-export {
-  runSourcesPending
-};