@hasna/knowledge 0.2.20 → 0.2.22

package/README.md

@@ -65,12 +65,22 @@ open-knowledge paths --scope project --json
 # Inspect local/S3 artifact storage and source ownership
 open-knowledge storage status --scope project --json
 
+# Configure optional hosted mode and inspect remote contracts
+open-knowledge setup --mode hosted --api-url https://knowledge.hasna.xyz --scope project --json
+open-knowledge auth whoami --scope project --json
+open-knowledge remote contracts --scope project --json
+
 # Initialize the project SQLite catalog
 open-knowledge db init --scope project
 
 # Initialize scalable wiki/schema/index/log artifacts
 open-knowledge wiki init --scope project
 
+# Compile cited wiki pages, file approved answers, and lint wiki health
+open-knowledge wiki compile "handbook policy" --title "Handbook Policy" --scope project --json
+open-knowledge wiki file-answer "How do we cite policy?" --content "Use cited source context." --approve-write --scope project --json
+open-knowledge wiki lint --scope project --json
+
 # Ingest an open-files source manifest into the project SQLite catalog
 open-knowledge ingest manifest ./open-files-manifest.jsonl --scope project --json
 
@@ -204,6 +214,23 @@ knowledge bucket/prefix while `open-files` remains the source of truth for raw
 source bytes. The command also reports artifact classes, allowed source ref
 schemes, and warnings for non-scalable or unsafe config.
 
+### setup / auth / remote
+```bash
+open-knowledge setup --mode local [--scope project] [--json]
+open-knowledge setup --mode hosted [--api-url https://knowledge.hasna.xyz] [--scope project] [--json]
+open-knowledge auth login --api-key <key> [--email you@example.com] [--org <slug>] [--scope project] [--json]
+open-knowledge auth whoami [--scope project] [--json]
+open-knowledge auth logout [--scope project] [--json]
+open-knowledge remote status [--scope project] [--json]
+open-knowledge remote contracts [--scope project] [--json]
+```
+Hosted mode mirrors the `open-skills` open-core pattern: the OSS package stays
+local-first, while `hosted.api_url`, `KNOWLEDGE_API_URL`, and
+`KNOWLEDGE_API_KEY` define an optional remote client boundary. Credentials are
+stored locally in `~/.hasna/knowledge/auth.json` or supplied by env vars.
+`remote contracts` prints the typed registry/search/ask/build/sync/status/logs
+and artifact API contract that a future SaaS wrapper can implement.
+
 ### db
 ```bash
 open-knowledge db init [--scope project]
@@ -215,11 +242,22 @@ Initialize or inspect the versioned SQLite catalog at
 ### wiki
 ```bash
 open-knowledge wiki init [--scope project]
+open-knowledge wiki compile [query|source-ref...] [--title <title>] [--limit <n>] [--scope project] [--json]
+open-knowledge wiki file-answer <prompt> --content <answer> [--approve-write] [--scope project] [--json]
+open-knowledge wiki lint [--scope project] [--json]
 ```
 Create starter generated-knowledge artifacts through the artifact store:
 `schemas/v1.md`, `indexes/root.md`, `wiki/README.md`, and a dated JSONL log
 partition.
 
+`wiki compile` turns existing source chunks into a cited Markdown page under
+`wiki/generated/`, updates `knowledge_indexes`, records citations and a concept
+backlink, and appends a JSONL log partition. `wiki file-answer` keeps answer
+filing as a dry run unless `--approve-write` is supplied, then writes a cited
+answer note under `wiki/answers/`. `wiki lint` checks generated pages for
+missing citations, stale citations, duplicate titles, orphan pages, unresolved
+source refs, contradiction markers, and new article candidates.
+
 ### source
 ```bash
 open-knowledge source resolve <source-ref> [--purpose knowledge_answer|knowledge_index] [--limit <n>] [--scope project] [--json]