@elevasis/core 0.22.0 → 0.24.0

package/src/knowledge/format.ts

@@ -1,99 +1,100 @@
-import type { OrgKnowledgeNode } from '../organization-model/domains/knowledge'
-import type { KnowledgeMount, ParsedKnowledgePath } from './queries'
-
-// ---------------------------------------------------------------------------
-// formatText
-// ---------------------------------------------------------------------------
-
-/**
- * Renders a list of `OrgKnowledgeNode` results as a human-friendly text table.
- *
- * Output format (one row per node):
- *   `<kind>  <id>  <title>  —  <summary (truncated to 80 chars)>`
- *
- * Returns `"(no results)"` when the array is empty.
- */
-export function formatText(results: OrgKnowledgeNode[]): string {
-  if (results.length === 0) {
-    return '(no results)'
-  }
-
-  const kindWidth = Math.max(...results.map((n) => n.kind.length), 8)
-  const idWidth = Math.max(...results.map((n) => n.id.length), 4)
-
-  const header = `${'KIND'.padEnd(kindWidth)}  ${'ID'.padEnd(idWidth)}  TITLE`
-  const divider = '-'.repeat(header.length + 20)
-
-  const rows = results.map((n) => {
-    const summary = n.summary.length > 80 ? n.summary.slice(0, 77) + '...' : n.summary
-    return `${n.kind.padEnd(kindWidth)}  ${n.id.padEnd(idWidth)}  ${n.title}  —  ${summary}`
-  })
-
-  return [header, divider, ...rows].join('\n')
-}
-
-// ---------------------------------------------------------------------------
-// formatJson
-// ---------------------------------------------------------------------------
-
-/**
- * Wrapped JSON envelope for machine-readable output.
- *
- * Shape: `{ path, mount, args, results }`
- *
- * - `path`    — the original path string passed to `parsePath`
- * - `mount`   — the resolved mount axis
- * - `args`    — the parsed arguments array
- * - `results` — the query results (array of `OrgKnowledgeNode` or string IDs)
- */
-export interface KnowledgeJsonEnvelope {
-  path: string
-  mount: KnowledgeMount
-  args: string[]
-  results: OrgKnowledgeNode[] | string[]
-}
-
-/**
- * Formats query results as a wrapped JSON envelope string.
- *
- * The envelope shape is `{ path, mount, args, results }`.  This is intentionally
- * NOT flat `{ results }` — consumers (agent skills, jq pipelines) need the
- * mount + args to know how to interpret the results array.
- *
- * @param input.path    - The original path string (e.g. `"/by-feature/sales.crm"`).
- * @param input.mount   - The resolved mount axis.
- * @param input.args    - The parsed argument array.
- * @param input.results - The query results.
- */
-export function formatJson(input: {
-  path: string
-  parsed: ParsedKnowledgePath
-  results: OrgKnowledgeNode[] | string[]
-}): string {
-  const envelope: KnowledgeJsonEnvelope = {
-    path: input.path,
-    mount: input.parsed.mount,
-    args: input.parsed.args,
-    results: input.results
-  }
-  return JSON.stringify(envelope, null, 2)
-}
-
-// ---------------------------------------------------------------------------
-// formatIdsOnly
-// ---------------------------------------------------------------------------
-
-/**
- * Renders results as newline-separated IDs for piping.
- *
- * - For `OrgKnowledgeNode[]` results: emits `node.id` per line.
- * - For `string[]` results (governs / governedBy): emits each string per line.
- *
- * Returns an empty string when the array is empty (suitable for `wc -l` piping).
- */
-export function formatIdsOnly(results: OrgKnowledgeNode[] | string[]): string {
-  if (results.length === 0) return ''
-
-  const ids = results.map((r) => (typeof r === 'string' ? r : r.id))
-  return ids.join('\n')
-}
+import type { OrgKnowledgeNode } from '../organization-model/domains/knowledge'
+import type { KnowledgeMount, ParsedKnowledgePath } from './queries'
+
+// ---------------------------------------------------------------------------
+// formatText
+// ---------------------------------------------------------------------------
+
+/**
+ * Renders a list of `OrgKnowledgeNode` results as a human-friendly text table.
+ *
+ * Output format (one row per node):
+ *   `<kind>  <id>  <title>  —  <summary (truncated to 80 chars)>`
+ *
+ * Returns `"(no results)"` when the array is empty.
+ */
+export function formatText(results: OrgKnowledgeNode[]): string {
+  if (results.length === 0) {
+    return '(no results)'
+  }
+
+  const kindWidth = Math.max(...results.map((n) => n.kind.length), 8)
+  const idWidth = Math.max(...results.map((n) => n.id.length), 4)
+
+  const header = `${'KIND'.padEnd(kindWidth)}  ${'ID'.padEnd(idWidth)}  TITLE`
+  const divider = '-'.repeat(header.length + 20)
+
+  const rows = results.map((n) => {
+    const summary = n.summary.length > 80 ? n.summary.slice(0, 77) + '...' : n.summary
+    return `${n.kind.padEnd(kindWidth)}  ${n.id.padEnd(idWidth)}  ${n.title}  —  ${summary}`
+  })
+
+  return [header, divider, ...rows].join('\n')
+}
+
+// ---------------------------------------------------------------------------
+// formatJson
+// ---------------------------------------------------------------------------
+
+/**
+ * Wrapped JSON envelope for machine-readable output.
+ *
+ * Shape: `{ path, mount, args, results }`
+ *
+ * - `path`    — the original path string passed to `parsePath`
+ * - `mount`   — the resolved mount axis
+ * - `args`    — the parsed arguments array
+ * - `results` — the query results (array of `OrgKnowledgeNode` or string IDs)
+ */
+export interface KnowledgeJsonEnvelope {
+  path: string
+  mount: KnowledgeMount
+  args: string[]
+  results: OrgKnowledgeNode[] | string[]
+}
+
+/**
+ * Formats query results as a wrapped JSON envelope string.
+ *
+ * The envelope shape is `{ path, mount, args, results }`.  This is intentionally
+ * NOT flat `{ results }` — consumers (agent skills, jq pipelines) need the
+ * mount + args to know how to interpret the results array.
+ *
+ * @param input.path    - The original path string (e.g. `"/by-system/sales.crm"`).
+ * @param input.mount   - The resolved mount axis.
+ * @param input.args    - The parsed argument array.
+ * @param input.results - The query results.
+ */
+export function formatJson(input: {
+  path: string
+  parsed: ParsedKnowledgePath
+  results: OrgKnowledgeNode[] | string[]
+}): string {
+  const envelope: KnowledgeJsonEnvelope = {
+    path: input.path,
+    mount: input.parsed.mount,
+    args: input.parsed.args,
+    results: input.results
+  }
+  return JSON.stringify(envelope, null, 2)
+}
+
+// ---------------------------------------------------------------------------
+// formatIdsOnly
+// ---------------------------------------------------------------------------
+
+/**
+ * Renders results as newline-separated IDs for piping.
+ *
+ * - For `OrgKnowledgeNode[]` results: emits `node.id` per line.
+ * - For `string[]` results (governs / governedBy): emits each string per line.
+ *
+ * Returns an empty string when the array is empty (suitable for `wc -l` piping).
+ */
+export function formatIdsOnly(results: OrgKnowledgeNode[] | string[]): string {
+  if (results.length === 0) return ''
+
+  const ids = results.map((r) => (typeof r === 'string' ? r : r.id))
+  return ids.join('\n')
+}
+

package/src/knowledge/index.ts

@@ -1,5 +1,5 @@
-export { byFeature, byKind, byOwner, governs, governedBy, parsePath } from './queries'
-export type { KnowledgeMount, ParsedKnowledgePath } from './queries'
-
-export { formatText, formatJson, formatIdsOnly } from './format'
-export type { KnowledgeJsonEnvelope } from './format'
+export { bySystem, byOntology, byKind, byOwner, governs, governedBy, parsePath } from './queries'
+export type { KnowledgeMount, ParsedKnowledgePath } from './queries'
+
+export { formatText, formatJson, formatIdsOnly } from './format'
+export type { KnowledgeJsonEnvelope } from './format'

package/src/knowledge/published.ts

@@ -1,5 +1,5 @@
-export { byFeature, byKind, byOwner, governs, governedBy, parsePath } from './queries'
-export type { KnowledgeMount, ParsedKnowledgePath } from './queries'
-
-export { formatText, formatJson, formatIdsOnly } from './format'
-export type { KnowledgeJsonEnvelope } from './format'
+export { bySystem, byKind, byOwner, governs, governedBy, parsePath } from './queries'
+export type { KnowledgeMount, ParsedKnowledgePath } from './queries'
+
+export { formatText, formatJson, formatIdsOnly } from './format'
+export type { KnowledgeJsonEnvelope } from './format'