glm-5.1
2b63cda1c7
Copy architecture docs, ADRs, storage domain specs, research, reviews, and 56 storage architecture tasks from the alkhub_ts monorepo. Adapt for standalone @alkdev/hub repo structure (src/ not packages/hub/). Sanitize all sensitive information: - Replace private IPs (10.0.0.1) with localhost defaults - Remove internal server hostnames (dev1, ns528096) - Replace /workspace/ private paths with npm package references - Remove hardcoded credentials from examples - Rewrite infrastructure.md without private network details Add Deno project scaffolding: deno.json (pinned deps), .gitignore, AGENTS.md, entry point. Migrate existing code stubs (crypto, config types, logger) with updated import paths.
2.0 KiB
id, name, status, depends_on, scope, risk, impact, level
| id | name | status | depends_on | scope | risk | impact | level |
|---|---|---|---|---|---|---|---|
| update-tasks-doc-for-taskgraph | Update storage/tasks.md for @alkdev/taskgraph | completed | narrow | low | component | implementation |
Description
Update the "Graphology Integration" section and sync flow in docs/architecture/storage/tasks.md to reference @alkdev/taskgraph instead of direct graphology usage.
Key changes
-
Graphology Integration section — Replace manual
DirectedGraphconstruction withTaskGraph.fromRecords():- Instead of "Load rows → Build a graphology DirectedGraph → Run algorithms", use "Load rows → Build a TaskGraph via
TaskGraph.fromRecords(tasks, edges)→ Run analysis functions" - Reference
@alkdev/taskgraphanalysis functions:criticalPath(),parallelGroups(),bottlenecks(),riskPath(),shouldDecomposeTask(),workflowCost() - Graphology is still a transitive dependency through
@alkdev/taskgraphbut hub code should prefer theTaskGraphAPI
- Instead of "Load rows → Build a graphology DirectedGraph → Run algorithms", use "Load rows → Build a TaskGraph via
-
NAPI note — Update "Why not taskgraph NAPI for v1" to note that
@alkdev/taskgraphis now the TypeScript package (pure graphology-based, <5ms for 100 nodes) and the Rust CLI is for offline analysis only. No NAPI needed. -
Frontmatter parsing — Reference
@alkdev/taskgraph'sparseFrontmatter()andserializeFrontmatter()functions for task file I/O. Note:parseTaskFile()andparseTaskDirectory()are Node.js only (usenode:fs/promises). For Deno, useparseFrontmatter()with Deno file I/O. -
References section — Update graphology link to reference the @alkdev/taskgraph package instead of local paths.
Acceptance Criteria
- Graphology Integration section references
TaskGraph.fromRecords()API - Analysis functions reference
@alkdev/taskgraphexports - NAPI note is updated for current state
- Frontmatter parsing references
@alkdev/taskgraphfunctions - References section updated
References
- docs/reviews/core-library-extraction-sync-2026-05-18.md (Section 2.7)