okforge 1.0.1

package/dist/commands/map_command.js

@@ -0,0 +1,16 @@
+import { OkfStore } from '../misc/okf_store.js';
+/** `map` — print the full folder -> sources mapping. */
+export class MapCommand {
+    /** The mapping as printable lines: `## <folder>` headers with `  - <source>` rows. */
+    static map(cwd) {
+        const lines = [];
+        for (const folder of OkfStore.folders(cwd)) {
+            lines.push(`## ${folder}`);
+            for (const source of OkfStore.sources(cwd, folder)) {
+                lines.push(`  - ${source}`);
+            }
+        }
+        return lines;
+    }
+}
+//# sourceMappingURL=map_command.js.map

package/dist/commands/map_command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map_command.js","sourceRoot":"","sources":["../../src/commands/map_command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,wDAAwD;AACxD,MAAM,OAAO,UAAU;IACtB,sFAAsF;IACtF,MAAM,CAAC,GAAG,CAAC,GAAW;QACrB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC;YAC3B,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC;gBACpD,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,EAAE,CAAC,CAAC;YAC7B,CAAC;QACF,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;CACD"}

package/dist/commands/nudge_command.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+/** Stop-hook payload read from stdin; only these flat fields are used. */
+declare const HookInputSchema: z.ZodObject<{
+    session_id: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    session_id: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    session_id: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+/** Parsed Stop-hook payload. */
+export type HookInput = z.infer<typeof HookInputSchema>;
+/**
+ * Stop-hook companion to the okf skill. When a session changed source that an OKF
+ * folder is derived from but left `okf/` untouched, it prints a gentle,
+ * non-blocking reminder to refresh the affected docs. It fires at most once per
+ * session and stays silent when `okf/` was already touched. The folder <-> source
+ * mapping lives in the repository's `.okforge.config.json`, so the hook and the
+ * skill read a single source of truth.
+ */
+export declare class NudgeCommand {
+    /** Read the hook payload from stdin and evaluate the nudge; never throws. */
+    static nudge(): Promise<void>;
+    /** Decide whether to nudge for this payload, printing the message when it fires. */
+    static evaluate(input: HookInput): void;
+    /** Read all of stdin as UTF-8 text. */
+    static readStdin(): Promise<string>;
+}
+export {};
+//# sourceMappingURL=nudge_command.d.ts.map

package/dist/commands/nudge_command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nudge_command.d.ts","sourceRoot":"","sources":["../../src/commands/nudge_command.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,0EAA0E;AAC1E,QAAA,MAAM,eAAe;;;;;;;;;gCAKN,CAAC;AAEhB,gCAAgC;AAChC,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;;;;;;GAOG;AACH,qBAAa,YAAY;IACxB,6EAA6E;WAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAenC,oFAAoF;IACpF,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IA2BvC,uCAAuC;WAC1B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;CAOzC"}

package/dist/commands/nudge_command.js

@@ -0,0 +1,72 @@
+import Fs from 'node:fs';
+import Path from 'node:path';
+import Os from 'node:os';
+import { z } from 'zod';
+import { OkfStore } from '../misc/okf_store.js';
+/** Stop-hook payload read from stdin; only these flat fields are used. */
+const HookInputSchema = z
+    .object({
+    session_id: z.string().optional(),
+    cwd: z.string().optional(),
+})
+    .passthrough();
+/**
+ * Stop-hook companion to the okf skill. When a session changed source that an OKF
+ * folder is derived from but left `okf/` untouched, it prints a gentle,
+ * non-blocking reminder to refresh the affected docs. It fires at most once per
+ * session and stays silent when `okf/` was already touched. The folder <-> source
+ * mapping lives in the repository's `.okforge.config.json`, so the hook and the
+ * skill read a single source of truth.
+ */
+export class NudgeCommand {
+    /** Read the hook payload from stdin and evaluate the nudge; never throws. */
+    static async nudge() {
+        try {
+            const raw = await NudgeCommand.readStdin();
+            let input = {};
+            try {
+                input = HookInputSchema.parse(JSON.parse(raw));
+            }
+            catch {
+                input = {};
+            }
+            NudgeCommand.evaluate(input);
+        }
+        catch {
+            // A Stop hook must never break the session; stay silent on any failure.
+        }
+    }
+    /** Decide whether to nudge for this payload, printing the message when it fires. */
+    static evaluate(input) {
+        const cwd = input.cwd !== undefined && input.cwd !== '' ? input.cwd : process.cwd();
+        const sessionId = input.session_id !== undefined && input.session_id !== '' ? input.session_id : 'nosession';
+        const marker = Path.join(Os.tmpdir(), `claude-okf-nudge-${sessionId}`);
+        // Already nudged this session, not a git repo, or okf/ already being touched.
+        if (Fs.existsSync(marker) === true) {
+            return;
+        }
+        if (OkfStore.isGitRepo(cwd) === false) {
+            return;
+        }
+        if (OkfStore.git(['status', '--porcelain', '--', 'okf'], cwd) !== '') {
+            return;
+        }
+        const stale = OkfStore.staleFolders(cwd);
+        if (stale.length === 0) {
+            return;
+        }
+        Fs.writeFileSync(marker, '');
+        const folders = stale.map((entry) => entry.folder).join(', ');
+        const message = `Source documented by the OKF bundle changed this session (${folders}) but okf/ was not updated. Consider running /okf refresh <folder> to keep the knowledge bundle in sync.`;
+        process.stdout.write(`${JSON.stringify({ systemMessage: message })}\n`);
+    }
+    /** Read all of stdin as UTF-8 text. */
+    static async readStdin() {
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+            chunks.push(Buffer.isBuffer(chunk) === true ? chunk : Buffer.from(chunk));
+        }
+        return Buffer.concat(chunks).toString('utf-8');
+    }
+}
+//# sourceMappingURL=nudge_command.js.map

package/dist/commands/nudge_command.js.map

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

package/dist/commands/sources_command.d.ts

@@ -0,0 +1,6 @@
+/** `sources` — print the source paths a folder is derived from. */
+export declare class SourcesCommand {
+    /** The source path prefixes `folder` is derived from; throws when undeclared. */
+    static sources(cwd: string, folder: string): string[];
+}
+//# sourceMappingURL=sources_command.d.ts.map

package/dist/commands/sources_command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources_command.d.ts","sourceRoot":"","sources":["../../src/commands/sources_command.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,qBAAa,cAAc;IAC1B,iFAAiF;IACjF,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;CAOrD"}

package/dist/commands/sources_command.js

@@ -0,0 +1,13 @@
+import { OkfStore } from '../misc/okf_store.js';
+/** `sources` — print the source paths a folder is derived from. */
+export class SourcesCommand {
+    /** The source path prefixes `folder` is derived from; throws when undeclared. */
+    static sources(cwd, folder) {
+        const prefixes = OkfStore.sources(cwd, folder);
+        if (prefixes.length === 0) {
+            throw new Error(`unknown folder: ${folder}`);
+        }
+        return prefixes;
+    }
+}
+//# sourceMappingURL=sources_command.js.map

package/dist/commands/sources_command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources_command.js","sourceRoot":"","sources":["../../src/commands/sources_command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,mEAAmE;AACnE,MAAM,OAAO,cAAc;IAC1B,iFAAiF;IACjF,MAAM,CAAC,OAAO,CAAC,GAAW,EAAE,MAAc;QACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,QAAQ,CAAC;IACjB,CAAC;CACD"}

package/dist/commands/stale_command.d.ts

@@ -0,0 +1,6 @@
+/** `stale` — folders whose source changed since HEAD while the folder was not edited. */
+export declare class StaleCommand {
+    /** Printable lines, one per stale folder: `<folder> (source changed: <path>)`. */
+    static stale(cwd: string): string[];
+}
+//# sourceMappingURL=stale_command.d.ts.map

package/dist/commands/stale_command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale_command.d.ts","sourceRoot":"","sources":["../../src/commands/stale_command.ts"],"names":[],"mappings":"AAEA,yFAAyF;AACzF,qBAAa,YAAY;IACxB,kFAAkF;IAClF,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;CAGnC"}

package/dist/commands/stale_command.js

@@ -0,0 +1,9 @@
+import { OkfStore } from '../misc/okf_store.js';
+/** `stale` — folders whose source changed since HEAD while the folder was not edited. */
+export class StaleCommand {
+    /** Printable lines, one per stale folder: `<folder> (source changed: <path>)`. */
+    static stale(cwd) {
+        return OkfStore.staleFolders(cwd).map(({ folder, source }) => `${folder} (source changed: ${source})`);
+    }
+}
+//# sourceMappingURL=stale_command.js.map

package/dist/commands/stale_command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale_command.js","sourceRoot":"","sources":["../../src/commands/stale_command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,yFAAyF;AACzF,MAAM,OAAO,YAAY;IACxB,kFAAkF;IAClF,MAAM,CAAC,KAAK,CAAC,GAAW;QACvB,OAAO,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,MAAM,qBAAqB,MAAM,GAAG,CAAC,CAAC;IACxG,CAAC;CACD"}

package/dist/misc/okf_store.d.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+/**
+ * The okforge config: the folder <-> source mapping for a repository. Each key
+ * is an OKF concept folder; each value is the list of source path prefixes that
+ * folder is derived from. A changed file under any prefix marks the folder stale.
+ * This is per-repository data — okforge ships with none of it.
+ */
+declare const OkfConfigSchema: z.ZodObject<{
+    folders: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    folders: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    folders: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+}, z.ZodTypeAny, "passthrough">>;
+/** Parsed okforge config. */
+export type OkfConfig = z.infer<typeof OkfConfigSchema>;
+/** A folder whose source changed without the folder itself being edited. */
+export type StaleFolder = {
+    folder: string;
+    source: string;
+};
+/** A single file or directory yielded by {@link OkfStore.walk}. */
+export type WalkEntry = {
+    path: string;
+    isDirectory: boolean;
+};
+/**
+ * Primitive mechanics shared by the okf subcommands: loading the per-repository
+ * folder <-> source mapping, git inspection, staleness detection, and the
+ * conformance / dead-link lint. The command classes orchestrate these primitives.
+ */
+export declare class OkfStore {
+    /** Absolute path of the config file for the repository at `cwd`. */
+    static configPath(cwd: string): string;
+    /**
+     * The folder <-> source mapping for the repository at `cwd`. Returns an empty
+     * mapping when no config exists, so okforge is a no-op until a repo declares
+     * one. Throws when the config is present but malformed.
+     */
+    static loadConfig(cwd: string): OkfConfig;
+    /** The OKF concept folder names declared in `cwd`'s config, in declared order. */
+    static folders(cwd: string): string[];
+    /** The source path prefixes `folder` is derived from, or `[]` when undeclared. */
+    static sources(cwd: string, folder: string): string[];
+    /** Run `git` in `cwd`, returning its stdout, or '' when the command fails. */
+    static git(args: string[], cwd: string): string;
+    /** Whether `cwd` is inside a git working tree. */
+    static isGitRepo(cwd: string): boolean;
+    /** Tracked-and-untracked paths changed since HEAD, sorted and de-duplicated. */
+    static changedPaths(cwd: string): string[];
+    /**
+     * Folders whose source changed since HEAD while the folder itself was not
+     * edited this session. Folders already being edited under `okf/<folder>` are
+     * skipped so the user is not nudged about work in progress.
+     */
+    static staleFolders(cwd: string): StaleFolder[];
+    /** First path in `changed` containing any of `prefixes` (substring match), or null. */
+    static firstMatch(changed: string[], prefixes: string[]): string | null;
+    /**
+     * Conformance + dead-link lint of the `okf/` bundle under `cwd`. Returns the
+     * list of problems (empty when conformant); throws when there is no bundle.
+     * Needs no mapping — it lints the bundle's markdown alone, so it is fully
+     * repository-agnostic.
+     */
+    static check(cwd: string): string[];
+    /** The count of concept docs (non-index, non-log `.md`) in the bundle under `cwd`. */
+    static conceptCount(cwd: string): number;
+    /** Whether `content` opens with a `---` block holding a non-empty `type:`. */
+    static hasTypeFrontmatter(content: string): boolean;
+    /** Distinct bundle-relative `.md` link targets across every doc, sorted. */
+    static bundleLinks(entries: WalkEntry[]): string[];
+    /** The first line of `content` (without its trailing newline). */
+    static firstLine(content: string): string;
+    /** Every file and directory under `dir`, recursively (excluding `dir` itself). */
+    static walk(dir: string): WalkEntry[];
+}
+export {};
+//# sourceMappingURL=okf_store.d.ts.map

package/dist/misc/okf_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"okf_store.d.ts","sourceRoot":"","sources":["../../src/misc/okf_store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;;GAKG;AACH,QAAA,MAAM,eAAe;;;;;;gCAIN,CAAC;AAEhB,6BAA6B;AAC7B,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,qBAAa,QAAQ;IACpB,oEAAoE;IACpE,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAItC;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAmBzC,kFAAkF;IAClF,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAIrC,kFAAkF;IAClF,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAKrD,8EAA8E;IAC9E,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAa/C,kDAAkD;IAClD,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAStC,gFAAgF;IAChF,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAU1C;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE;IA0B/C,uFAAuF;IACvF,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI;IAavE;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAoDnC,sFAAsF;IACtF,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAexC,8EAA8E;IAC9E,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAkBnD,4EAA4E;IAC5E,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE;IAiBlD,kEAAkE;IAClE,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIzC,kFAAkF;IAClF,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE;CAerC"}

package/dist/misc/okf_store.js

@@ -0,0 +1,261 @@
+import Fs from 'node:fs';
+import Path from 'node:path';
+import ChildProcess from 'node:child_process';
+import { z } from 'zod';
+/** Config file name read from the repository root. */
+const CONFIG_FILENAME = '.okforge.config.json';
+/**
+ * The okforge config: the folder <-> source mapping for a repository. Each key
+ * is an OKF concept folder; each value is the list of source path prefixes that
+ * folder is derived from. A changed file under any prefix marks the folder stale.
+ * This is per-repository data — okforge ships with none of it.
+ */
+const OkfConfigSchema = z
+    .object({
+    folders: z.record(z.string(), z.array(z.string())).default({}),
+})
+    .passthrough();
+/**
+ * Primitive mechanics shared by the okf subcommands: loading the per-repository
+ * folder <-> source mapping, git inspection, staleness detection, and the
+ * conformance / dead-link lint. The command classes orchestrate these primitives.
+ */
+export class OkfStore {
+    /** Absolute path of the config file for the repository at `cwd`. */
+    static configPath(cwd) {
+        return Path.join(cwd, CONFIG_FILENAME);
+    }
+    /**
+     * The folder <-> source mapping for the repository at `cwd`. Returns an empty
+     * mapping when no config exists, so okforge is a no-op until a repo declares
+     * one. Throws when the config is present but malformed.
+     */
+    static loadConfig(cwd) {
+        const configPath = OkfStore.configPath(cwd);
+        if (Fs.existsSync(configPath) === false) {
+            return { folders: {} };
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(Fs.readFileSync(configPath, 'utf-8'));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`invalid JSON in ${CONFIG_FILENAME}: ${message}`);
+        }
+        const result = OkfConfigSchema.safeParse(parsed);
+        if (result.success === false) {
+            throw new Error(`invalid ${CONFIG_FILENAME}: ${result.error.issues.map((issue) => issue.message).join('; ')}`);
+        }
+        return result.data;
+    }
+    /** The OKF concept folder names declared in `cwd`'s config, in declared order. */
+    static folders(cwd) {
+        return Object.keys(OkfStore.loadConfig(cwd).folders);
+    }
+    /** The source path prefixes `folder` is derived from, or `[]` when undeclared. */
+    static sources(cwd, folder) {
+        const prefixes = OkfStore.loadConfig(cwd).folders[folder];
+        return prefixes === undefined ? [] : [...prefixes];
+    }
+    /** Run `git` in `cwd`, returning its stdout, or '' when the command fails. */
+    static git(args, cwd) {
+        try {
+            return ChildProcess.execFileSync('git', args, {
+                cwd,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+                maxBuffer: 32 * 1024 * 1024,
+            });
+        }
+        catch {
+            return '';
+        }
+    }
+    /** Whether `cwd` is inside a git working tree. */
+    static isGitRepo(cwd) {
+        try {
+            ChildProcess.execFileSync('git', ['rev-parse', '--git-dir'], { cwd, stdio: 'ignore' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Tracked-and-untracked paths changed since HEAD, sorted and de-duplicated. */
+    static changedPaths(cwd) {
+        const tracked = OkfStore.git(['diff', '--name-only', 'HEAD'], cwd);
+        const untracked = OkfStore.git(['ls-files', '--others', '--exclude-standard'], cwd);
+        const paths = `${tracked}\n${untracked}`
+            .split('\n')
+            .map((line) => line.trim())
+            .filter((line) => line !== '');
+        return [...new Set(paths)].sort();
+    }
+    /**
+     * Folders whose source changed since HEAD while the folder itself was not
+     * edited this session. Folders already being edited under `okf/<folder>` are
+     * skipped so the user is not nudged about work in progress.
+     */
+    static staleFolders(cwd) {
+        if (OkfStore.isGitRepo(cwd) === false) {
+            return [];
+        }
+        const config = OkfStore.loadConfig(cwd);
+        const folders = Object.keys(config.folders);
+        if (folders.length === 0) {
+            return [];
+        }
+        const changed = OkfStore.changedPaths(cwd);
+        if (changed.length === 0) {
+            return [];
+        }
+        const stale = [];
+        for (const folder of folders) {
+            if (OkfStore.git(['status', '--porcelain', '--', `okf/${folder}`], cwd) !== '') {
+                continue;
+            }
+            const source = OkfStore.firstMatch(changed, config.folders[folder]);
+            if (source !== null) {
+                stale.push({ folder, source });
+            }
+        }
+        return stale;
+    }
+    /** First path in `changed` containing any of `prefixes` (substring match), or null. */
+    static firstMatch(changed, prefixes) {
+        for (const prefix of prefixes) {
+            if (prefix === '') {
+                continue;
+            }
+            const match = changed.find((path) => path.includes(prefix));
+            if (match !== undefined) {
+                return match;
+            }
+        }
+        return null;
+    }
+    /**
+     * Conformance + dead-link lint of the `okf/` bundle under `cwd`. Returns the
+     * list of problems (empty when conformant); throws when there is no bundle.
+     * Needs no mapping — it lints the bundle's markdown alone, so it is fully
+     * repository-agnostic.
+     */
+    static check(cwd) {
+        const root = Path.join(cwd, 'okf');
+        if (Fs.existsSync(root) === false || Fs.statSync(root).isDirectory() === false) {
+            throw new Error(`no okf/ bundle at ${root}`);
+        }
+        const problems = [];
+        const entries = OkfStore.walk(root);
+        // 1. snake_case names only (no kebab-case in any file or directory name).
+        for (const entry of entries) {
+            if (Path.basename(entry.path).includes('-') === true) {
+                problems.push(`NAME: kebab-case not allowed: ${Path.relative(cwd, entry.path)}`);
+            }
+        }
+        // 2. every non-index .md has frontmatter with a non-empty type.
+        for (const entry of entries) {
+            if (entry.isDirectory === true) {
+                continue;
+            }
+            const name = Path.basename(entry.path);
+            if (name.endsWith('.md') === false || name === 'index.md' || name === 'log.md') {
+                continue;
+            }
+            if (OkfStore.hasTypeFrontmatter(Fs.readFileSync(entry.path, 'utf-8')) === false) {
+                problems.push(`TYPE: missing/empty frontmatter type: ${Path.relative(cwd, entry.path)}`);
+            }
+        }
+        // 3. sub-folder index.md must carry no frontmatter (root index.md may).
+        for (const entry of entries) {
+            if (entry.isDirectory === true || Path.basename(entry.path) !== 'index.md') {
+                continue;
+            }
+            if (entry.path === Path.join(root, 'index.md')) {
+                continue;
+            }
+            if (OkfStore.firstLine(Fs.readFileSync(entry.path, 'utf-8')) === '---') {
+                problems.push(`INDEX: sub-folder index.md must not have frontmatter: ${Path.relative(cwd, entry.path)}`);
+            }
+        }
+        // 4. bundle-relative links (/foo/bar.md) must resolve to a file.
+        for (const link of OkfStore.bundleLinks(entries)) {
+            if (Fs.existsSync(Path.join(root, link)) === false) {
+                problems.push(`LINK: dangling bundle link: ${link}`);
+            }
+        }
+        return problems;
+    }
+    /** The count of concept docs (non-index, non-log `.md`) in the bundle under `cwd`. */
+    static conceptCount(cwd) {
+        const root = Path.join(cwd, 'okf');
+        let count = 0;
+        for (const entry of OkfStore.walk(root)) {
+            if (entry.isDirectory === true) {
+                continue;
+            }
+            const name = Path.basename(entry.path);
+            if (name.endsWith('.md') === true && name !== 'index.md' && name !== 'log.md') {
+                count += 1;
+            }
+        }
+        return count;
+    }
+    /** Whether `content` opens with a `---` block holding a non-empty `type:`. */
+    static hasTypeFrontmatter(content) {
+        const lines = content.split('\n');
+        if (lines.length === 0 || lines[0] !== '---') {
+            return false;
+        }
+        let seenType = false;
+        for (let index = 1; index < lines.length; index += 1) {
+            const line = lines[index];
+            if (line === '---') {
+                return seenType;
+            }
+            if (/^type:[ \t]*[^ \t]+/.test(line) === true) {
+                seenType = true;
+            }
+        }
+        return false;
+    }
+    /** Distinct bundle-relative `.md` link targets across every doc, sorted. */
+    static bundleLinks(entries) {
+        const links = new Set();
+        const pattern = /\]\((\/[a-z0-9_./-]+\.md)\)/g;
+        for (const entry of entries) {
+            if (entry.isDirectory === true || entry.path.endsWith('.md') === false) {
+                continue;
+            }
+            const content = Fs.readFileSync(entry.path, 'utf-8');
+            let match = pattern.exec(content);
+            while (match !== null) {
+                links.add(match[1]);
+                match = pattern.exec(content);
+            }
+        }
+        return [...links].sort();
+    }
+    /** The first line of `content` (without its trailing newline). */
+    static firstLine(content) {
+        return content.split('\n', 1)[0] ?? '';
+    }
+    /** Every file and directory under `dir`, recursively (excluding `dir` itself). */
+    static walk(dir) {
+        const result = [];
+        if (Fs.existsSync(dir) === false) {
+            return result;
+        }
+        for (const entry of Fs.readdirSync(dir, { withFileTypes: true })) {
+            const childPath = Path.join(dir, entry.name);
+            const isDirectory = entry.isDirectory();
+            result.push({ path: childPath, isDirectory });
+            if (isDirectory === true) {
+                result.push(...OkfStore.walk(childPath));
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=okf_store.js.map

package/dist/misc/okf_store.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+	"name": "okforge",
+	"version": "1.0.1",
+	"description": "Open Knowledge Format (OKF) skill for Claude Code — deterministic okf bundle mechanics and a Stop-hook nudge.",
+	"type": "module",
+	"bin": {
+		"okforge": "dist/cli.js"
+	},
+	"main": "dist/cli.js",
+	"types": "dist/cli.d.ts",
+	"files": [
+		"dist",
+		".claude/skills",
+		"LICENSE"
+	],
+	"engines": {
+		"node": ">=20.12"
+	},
+	"scripts": {
+		"okforge": "tsx src/cli.ts",
+		"typecheck": "tsc --noEmit",
+		"build": "tsc -p tsconfig.build.json",
+		"publish:all": "npm run build && npm version patch && npm publish"
+	},
+	"author": {
+		"name": "Jerome Etienne",
+		"email": "jerome.etienne@gmail.com"
+	},
+	"license": "MIT",
+	"keywords": [
+		"claude-code",
+		"okf",
+		"open-knowledge-format",
+		"knowledge-bundle",
+		"skill"
+	],
+	"dependencies": {
+		"chalk": "^5.3.0",
+		"commander": "^12.1.0",
+		"zod": "^3.23.8"
+	},
+	"devDependencies": {
+		"@types/node": "^22.10.0",
+		"tsx": "^4.19.2",
+		"typescript": "^5.7.2"
+	}
+}